Settings.this

Creates a new #GSettings 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), g_settings_schema_source_lookup() can be used to test for their existence before loading them.

Signals on the newly created #GSettings object will be dispatched via the thread-default #GMainContext in effect at the time of the call to g_settings_new(). The new #GSettings will hold a reference on the context. See g_main_context_push_thread_default().

Parameters

schemaId string

the id of the schema

Return Value

a new #GSettings object

Throws

ConstructionException GTK+ fails to create the object.

Meta

Since

2.26