类
戈ObjectParamSpecParam
描述 [源]
final class GObject.ParamSpecParam : GObject.TypeInstance
{
/* No available fields */
}
一个包含 戈_TYPE_PARAM
属性元数据的 戈ParamSpec
派生结构。
实例方法
从 戈ParamSpec 继承的方法 (14)
g_param_spec_get_blurb
获取一个 戈ParamSpec
的简短描述。
g_param_spec_get_default_value
获取 pspec
的默认值,以 GValue
指针的形式。
自版本 2.38
g_param_spec_get_name
获取一个 戈ParamSpec
的名称。
g_param_spec_get_name_quark
获取名称的 GQuark。
自版本 2.46
g_param_spec_get_nick
获取一个 戈ParamSpec
的昵称。
g_param_spec_get_qdata
通过 g_param_spec_set_qdata() 存储返回用户数据指针。
g_param_spec_get_redirect_target
如果 paramspec 将操作重定向到另一个 paramspec,则返回该 paramspec。重定向通常用于在一个派生类型中提供属性的新实现,同时保留父类型中所有的属性。通过创建类型为 戈ParamSpecOverride
的属性来建立重定向。有关此功能的示例,请参阅 g_object_class_override_property()
。
自版本 2.4
g_param_spec_ref
增加 pspec
的引用计数。
g_param_spec_ref_sink
引用并吸收一个 戈ParamSpec
的便利函数。
自版本 2.10
g_param_spec_set_qdata
在 戈ParamSpec
上设置一个不透明、命名指针。通过 GQuark
(例如通过 g_quark_from_static_string() 检索)指定名称,可以通过 g_param_spec_get_qdata() 从 pspec
获取指针。设置已设置的用户数据指针将覆盖(释放)旧指针,使用 NULL
作为指针实质上是删除存储的数据。
g_param_spec_set_qdata_full
此函数类似 g_param_spec_set_qdata(),但还可以指定一个 void (*destroy) (gpointer)
函数,当 pspec
最终确定或数据被与相同 quark
的调用 g_param_spec_set_qdata() 覆盖时,该函数以 data
作为参数调用。
g_param_spec_sink
新创建的 戈ParamSpec
的初始引用计数为 1,即使尚未有人明确对其调用 g_param_spec_ref()
。因此,初始引用计数被标记为“浮动”,直到有人按顺序调用 g_param_spec_ref (pspec); g_param_spec_sink (pspec);
,接管初始引用计数(从而最终得到一个引用计数为 1 的 pspec
,但不再是“浮动”的)。
g_param_spec_steal_qdata
通过 g_param_spec_set_qdata() 存储获取用户数据指针,并从 pspec
中删除 data
而不调用其 destroy()
函数(如果有)。通常,调用此函数仅需要更新带有销毁通知器的用户数据指针。
g_param_spec_unref
减少 pspec
的引用计数。