类
GObjectParamSpecLong
描述 [来源]
final class GObject.ParamSpecLong : GObject.TypeInstance
{
minimum: glong,
maximum: glong,
default_value: glong
}
派生 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)
函数,在最终确定 pspec
时以 data
为参数调用该函数,或通过使用相同的 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
的引用计数。