方法

GioSettingsbind

自 2.26 版本以来

声明 [src]

void
g_settings_bind (
  GSettings* settings,
  const gchar* key,
  GObject* object,
  const gchar* property,
  GSettingsBindFlags flags
)

描述 [src]

在设置项对象中的 key 与 object 的属性 property 之间创建绑定。

此绑定使用默认的 GIO 映射函数将设置和属性值之间的映射。这些函数以简单的方式处理布尔类型、数值类型和字符串类型。如果需要自定义映射，请使用 g_settings_bind_with_mapping()，或者使用默认映射函数不支持的数据类型进行映射。

除非 flags 包含 G_SETTINGS_BIND_NO_SENSITIVITY，此函数还会在 key 的可写性和对象的“sensitive”属性（如果对象有以该名称命名的布尔属性）之间建立绑定（如果对象有以该名称命名的布尔属性）。有关可写匹配的更多详细信息，请参阅 g_settings_bind_writable()。

请注意，绑定的生命周期与 object 相关联，并且每个对象属性只能有一个绑定。如果在同一对象上对同一属性进行两次绑定，则第二次绑定会覆盖第一次。

自 2.26 版本起可用。

参数

key

类型: const gchar*

绑定的键。

数据由方法的调用者拥有。
值是一个以 NUL 结尾的 UTF-8 字符串。
object

类型: GObject

一个 GObject。

数据由方法的调用者拥有。
property

类型: const gchar*

要绑定的属性的名称。

数据由方法的调用者拥有。
值是一个以 NUL 结尾的 UTF-8 字符串。
flags

类型: GSettingsBindFlags

绑定的标志。