类
GObjectParamSpecObject
描述 [src]
final class GObject.ParamSpecObject : GObject.TypeInstance
{
/* No available fields */
}
包含对象属性的元数据的派生 GParamSpec
结构。
实例方法
从 GParamSpec 继承的方法 (14)
g_param_spec_get_blurb
获取 GParamSpec
的简短说明。
g_param_spec_get_default_value
以指向 GValue
的指针的形式获取 pspec
的默认值。
自:2.38
g_param_spec_get_name
获取 GParamSpec
的名称。
g_param_spec_get_name_quark
获取名称的 GQuark。
自:2.46
g_param_spec_get_nick
获取 GParamSpec
的昵称。
g_param_spec_get_qdata
获取通过 g_param_spec_set_qdata() 存储的用户数据指针。
g_param_spec_get_redirect_target
如果 paramspec 将操作重定向到另一个 paramspec,则返回该 paramspec。通常将重定向用于在派生类型中提供属性的新实现,同时保留来自父类型的全部属性。通过创建类型为 GParamSpecOverride
的属性建立重定向。有关此功能用法的示例,请参见 g_object_class_override_property()
。
自:2.4
g_param_spec_ref
增加 pspec
的引用计数。
g_param_spec_ref_sink
引用并销毁 GParamSpec
的便捷函数。
自:2.10
g_param_spec_set_qdata
在 GParamSpec
上设置一个不透明命名指针。名称通过 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)
函数,在使用 data
作为参数对 pspec
进行最终处理或者数据被具有相同 quark
的 g_param_spec_set_qdata()
调用覆盖时,用其进行调用。
g_param_spec_sink
新创建的 GParamSpec
的初始引用计数为 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
的引用计数。