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

a Gio.SettingsSchema

backend

a Gio.SettingsBackend

path

the path to use

Returns

a new Gio.Settings object