类
GObjectParamSpecUChar
描述 [src]
final class GObject.ParamSpecUChar : GObject.TypeInstance
{
minimum: guint8,
maximum: guint8,
default_value: guint8
}
派生自 GParamSpec
的结构,它包含了一种无符号字符特性的元数据。
实例方法
从 GParamSpec(14)继承的方法
g_param_spec_get_blurb
获取 GParamSpec
的简短描述。
g_param_spec_get_default_value
作为指向 GValue
的指针获取 pspec
的默认值。
since: 2.38
g_param_spec_get_name
获取 GParamSpec
的名称。
g_param_spec_get_name_quark
获取名称的 GQuark。
since: 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()
。
since: 2.4
g_param_spec_ref
增加 pspec
的引用计数。
g_param_spec_ref_sink
便捷函数,用于引用和下沉 GParamSpec
。
since: 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)
函数,当 pspec
完成或数据被调用 g_param_spec_set_qdata()
时,以此数据作为 quark
进行覆盖。
g_param_spec_sink
新创建的 GParamSpec
的初始引用计数为 1,即使还没有人明确地在此上调用 g_param_spec_ref()
。因此,初始引用计数被标记为“浮动”,直到有人按顺序在此调用 g_param_spec_ref (pspec); g_param_spec_sink (pspec);
,接管初始引用计数(因此最终得到一个 pspec
,其引用计数仍为 1,但不再标有“浮动”)。
g_param_spec_steal_qdata
取回通过 g_param_spec_set_qdata()
存储的用户数据指针,并从 pspec
中删除 data
,而不调用其 destroy()
函数(如果设置了)。通常,只有需要使用销毁通知更新用户数据指针时,才需要调用此函数。
g_param_spec_unref
递减 pspec
的引用计数。