Settings.full


Description:

[ CCode ( has_construct_function = false ) ]
[ Version ( since = "2.32" ) ]
public Settings.full (SettingsSchema schema, SettingsBackend? backend, string? path)

Creates a new [class@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 [class@Gio.Settings] object is a pure composition of four things: a [struct@Gio.SettingsSchema], a [ class@Gio.SettingsBackend], a path within that backend, and a [struct@GLib.MainContext] to which signals are dispatched.

This constructor therefore gives you full control over constructing [class@Gio.Settings] instances. The first 3 parameters are given directly as schema, backend and path, and the main context is taken from the thread-default (as per [ ctor@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 if 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.

Parameters:

schema

the schema describing the settings

backend

the settings backend to use

path

the path to use

Returns:

a new [class@Gio.Settings] object