方法

GioSettingsBackendpath_changed

自 2.26 以来

声明 [src]

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

描述 [src]

表示给定路径以下的所有键可能已更改。后端实现应在此方法中调用,如果整个键路径的值可能已更改。

path 必须是有效的路径(即以斜杠开头和结尾,且不包含‘//’)。

此信号的含义是,任何名称以 path 开头的键都可能已更改。

必须通知时适用的规则与 g_settings_backend_changed() 一致。此调用可能是对“重置”调用的适当响应,但实现也可以自由地列出受该调用影响的键,如果它们能够轻松做到这一点。

出于效率考虑,实现应努力使 path 尽可能长(即:所有更改的键的最长公共前缀),但这不是强制性的。例如,如果调用此函数时带有路径“/”,则应用中的每个键都将收到可能的更改通知。

自 2.26 起可用

参数

path

类型: const gchar*

包含更改的路径。

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

类型: gpointer

原始标记。

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