Gio.Settings.new_full
function new_full(schema: Gio.SettingsSchema, backend: Gio.SettingsBackend, path: String): Gio.Settings { // Gjs wrapper for g_settings_new_full() }
Creates a new Gio.Settings 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 Gio.Settings object is a pure composition of 4 things: a Gio.SettingsSchema, a Gio.SettingsBackend, a path within that backend, and a GLib.MainContext to which signals are dispatched.
This constructor therefore gives you full control over constructing Gio.Settings instances. The first 4 parameters are given directly as schema, backend and path, and the main context is taken from the thread-default (as per Gio.Settings.new).
If backend is null then the default backend is used.
If path is null then the path from the schema is used. It is an error f path is null and the schema has no path of its own or if path is non-null and not equal to the path that the schema does have.
Since 2.32
- schema
- backend
- path
the path to use
- Returns
a new Gio.Settings object