构造函数
GioSettingsnew_full
自:2.32
声明 [源]
GSettings*
g_settings_new_full (
GSettingsSchema* schema,
GSettingsBackend* backend,
const gchar* path
)
描述 [源]
使用给定的规范、后端和路径创建一个新 GSettings
对象。
通常不会想使用此函数。它提供高级用例使用(如插件系统想要提供访问从自定义位置加载的规范等)。
在最基本层面,GSettings
对象是4个东西的纯粹组合:一个 GSettingsSchema
,一个 GSettingsBackend
,后端内的路径,以及一个收发信号的主上下文。
因此,该构造函数允许您完全控制构建 GSettings
实例。前3个参数直接作为 schema
、backend
和 path
提供,主上下文从线程默认值(根据 g_settings_new())获取。
如果 backend
是 NULL
,则使用默认后端。
如果 path
是 NULL
,则使用从规范中得到的路径。如果 path
是 NULL
且规范本身没有路径,或者如果 path
非 NULL
但不等于规范具有的路径,则为错误。
自:2.32
参数
schema
-
类型:
GSettingsSchema
一个
GSettingsSchema
。数据由函数的调用者拥有的。 backend
-
类型:
GSettingsBackend
A
GSettingsBackend
。参数可以是 NULL
。数据由函数的调用者拥有的。 path
-
类型:
const gchar*
要使用的路径。
参数可以是 NULL
。数据由函数的调用者拥有的。 值是一个以空字符终止的UTF-8字符串。
返回值
类型: GSettings
一个新的 GSettings
对象。
函数的调用者拥有数据,并负责释放它。 |