方法

GioSettingsBackendkeys_changed

自 2.26 版本以来

声明 [src]

void
g_settings_backend_keys_changed (
  GSettingsBackend* backend,
  const gchar* path,
  const gchar* const* items,
  gpointer origin_tag
)

描述 [src]

发出信号,指示一组键可能已更改。后端实现应在此处调用,如果键的值可能已更改。

path 必须是一个有效路径(即以斜杠开始和结尾,且不包含 ‘//’)。items 中的每个字符串在 path 前缀后必须形成一个有效的键名(即每个项目不得以 ‘/’ 开头或结尾,并且不得包含‘//’)。

此信号的含义是,将 pathitems 中的每个项目连接起来获得的任何键名都可能已更改。

必须发生通知的时间规则与 g_settings_backend_changed() 一致。当恰好有一个项目更改时,这两个调用可以互换使用(尽管在这种情况下,g_settings_backend_changed() 绝对优先)。

由于效率原因,实现应尽量使 path 尽可能长(即所有更改的键的最长公共前缀),但这不是强制的。

自 2.26 版本以来提供

参数

path

类型: const gchar*

包含更改的路径。

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

类型: 一个 gchar* 的数组

改变的键的 NULL-终止的列表。

此数组必须以 NULL 结尾。
数据由方法的调用者拥有。
每个元素是一个 NUL 结束的 UTF-8 字符串。
origin_tag

类型: gpointer

原始  标签。

该参数可以是 NULL
数据由方法的调用者拥有。