方法

GioSettingsget_default_value

自:2.40

声明 [src]

GVariant*
g_settings_get_default_value (
  GSettings* settings,
  const gchar* key
)

描述 [src]

获取键的“默认值”。

这是在调用 g_settings_reset() 时读取的值。

请注意,这可能与 g_settings_schema_key_get_default_value() 返回的值不同,如果系统管理员已提供默认值。

比较 g_settings_get_default_value()g_settings_get_value() 的返回值不足以确定是否设置了值,因为用户可能明确地将值设置为一个恰好等于默认值的东西。这里的区别是,如果默认值在未来发生变化,用户的键仍然设置。

此函数可用于向用户界面 (UI) 添加指示之前用户设置的默认值。

如果提供的是 settings 处理方案中不包含的 key,则这是一个编程错误。

自:2.40

参数

key

类型: const gchar*

要获取默认值的键。

数据属于方法调用者。
该值是 NUL 结尾的 UTF-8 字符串。

返回值

类型: GVariant

默认值。

该方法调用者获取返回数据的所有权,并负责释放它。
返回值可以是 NULL