类
GObjectParamSpecPointer
说明 [源代码]
final class GObject.ParamSpecPointer : 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
如果参数规范将操作重定向到另一个参数规范,则返回该参数规范。重定向通常用于在派生类型中提供属性的新实现,同时保留父类型中的所有属性。通过创建类型为 GParamSpecOverride 的属性建立重定向。有关此功能使用情况的示例,请参见 g_object_class_override_property()。
自:2.4
g_param_spec_ref
增加 pspec 的引用计数。
g_param_spec_ref_sink
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() 存储的用户数据指针,并将 data 从 pspec 中移除,而不调用其 destroy() 函数(如果设置了的话)。通常,只有在使用销毁通知更新用户数据指针时才需要调用此函数。
g_param_spec_unref
减少 pspec 的引用计数。