构造函数

GioSettingsnew

自:2.26

声明 [src]

GSettings*
g_settings_new (
  const gchar* schema_id
)

说明 [src]

根据schema_id指定的模式创建一个新的GSettings对象。

如果模式不存在,则会发生错误:模式是程序的一个基本组成部分,因为它们提供类型信息。如果需要动态加载模式(例如,从可选的运行时依赖项),可以使用g_settings_schema_source_lookup()在加载它们之前检查它们的存在。

新创建的GSettings对象上的信号将通过在g_settings_new()调用时有效的线程默认GMainContext分派。新的GSettings将保持对上下文的引用。参见g_main_context_push_thread_default()。

自可用:2.26

参数

schema_id

类型: const gchar*

模式的标识符。

数据由函数的调用者拥有。
该值是一个以NULL终止的UTF-8字符串。

返回值

类型: GSettings

一个新的GSettings对象。

函数的调用者将拥有数据,并负责释放它。