Settings

constructor(schemaId: String)

Creates a new #GSettings object with the schema specified by

Return

a new #GSettings object

Since

2.26

Parameters

schemaId

the id of the schema


constructor(schema: SettingsSchema, backend: SettingsBackend? = null, path: String? = null)

Creates a new #GSettings object with a given schema, backend and path.

It should be extremely rare that you ever want to use this function. It is made available for advanced use-cases (such as plugin systems that want to provide access to schemas loaded from custom locations, etc).

At the most basic level, a #GSettings object is a pure composition of 4 things: a #GSettingsSchema, a #GSettingsBackend, a path within that backend, and a #GMainContext to which signals are dispatched.

This constructor therefore gives you full control over constructing #GSettings instances. The first 3 parameters are given directly as

Return

a new #GSettings object

Since

2.32

Parameters

schema

a #GSettingsSchema

backend

a #GSettingsBackend

path

the path to use


constructor(schemaId: String, backend: SettingsBackend)

Creates a new #GSettings object with the schema specified by

Return

a new #GSettings object

Since

2.26

Parameters

schemaId

the id of the schema

backend

the #GSettingsBackend to use


constructor(schemaId: String, backend: SettingsBackend, path: String)

Creates a new #GSettings object with the schema specified by

Return

a new #GSettings object

Since

2.26

Parameters

schemaId

the id of the schema

backend

the #GSettingsBackend to use

path

the path to use


constructor(schemaId: String, path: String)

Creates a new #GSettings object with the relocatable schema specified by @schema_id and a given path.

You only need to do this if you want to directly create a settings object with a schema that doesn't have a specified path of its own. That's quite rare.

It is a programmer error to call this function for a schema that has an explicitly specified path.

It is a programmer error if @path is not a valid path. A valid path begins and ends with '/' and does not contain two consecutive '/' characters.

Return

a new #GSettings object

Since

2.26

Parameters

schemaId

the id of the schema

path

the path to use


constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)