Package: gio

Function gio:settings-bind

Lambda List

gio:settings-bind (settings key object property flags)

Arguments

settings -- a g:settings object
key -- a string for the key to bind
object -- a g:object object for the object with the property to bind
property -- a string for the name of the property to bind
flags -- a g:settings-bind-flags value for the binding

Details

Create a binding between key in the settings object and the property property of object. The binding uses the default GIO mapping functions to map between the settings and property values. These functions handle booleans, numeric types and string types in a straightforward way. Use the g:settings-bind-with-mapping function if you need a custom mapping, or map between types that are not supported by the default mapping functions.

Unless the flags include no-sensitivity, this function also establishes a binding between the writability of key and the sensitive property of object, if object has a boolean property by that name. See the g:settings-bind-writable function for more details about writable bindings.

Note that the lifecycle of the binding is tied to object, and that you can have only one binding per object property. If you bind the same property twice on the same object, the second binding overrides the first one.
 

See also

#2026-03-25