Package: gio

Function gio:settings-new

Lambda List

gio:settings-new (schema-id)

Arguments

schema-id -- a string for the ID of the schema

Details

Creates a new g:settings object with the schema specified by schema-id. It is an error for the schema to not exist. Schemas are an essential part of a program, as they provide type information. If schemas need to be dynamically loaded, for example, from an optional runtime dependency, the g:settings-schema-source-lookup function can be used to test for their existence before loading them.

Signals on the newly created g:settings object will be dispatched via the thread-default GMainContext in effect at the time of the call to the g:settings-new function. The new g:settings object will hold a reference on the context.
 

See also

2025-12-29