信号

Gio Settings::change-event

声明

gboolean
change_event (
  GSettings* self,
  gpointer keys,
  gint n_keys,
  gpointer user_data
)

描述 [src]

“change-event” 信号会在影响该设置对象的每次更改事件中发出一次。只有在你对在“changed”信号多次发出之前查看更改组感兴趣时,才应连接到此信号。对于大多数用例,使用“changed”信号更为合适。

如果更改事件适用于一个或多个指定的键,则“keys”将是一个长度为“n_keys”的 GQuark 数组。如果更改事件适用于整个 GSettings 对象(即:可能每个键都已更改),则“keys”将为 NULL,且“n_keys”将等于 0。

此信号默认处理程序会对每个受影响的键调用“changed”信号。如果连接的任何其他处理程序返回 TRUE,则此默认功能将被抑制。

默认处理程序

默认处理程序在通过 g_signal_connect() 添加的处理程序之后被调用。

参数

keys

类型: 一组 GQuark

   an array of `GQuarks` for the changed keys, or `NULL`.
参数可以是 NULL
数组的长度由 n_keys 参数指定。
n_keys

类型: gint

“keys”数组的长度,或为 0。

返回值

类型: gboolean

返回 TRUE 以阻止其他处理程序为事件调用。返回 FALSE 以进一步传播事件。