GObjectParamSpecString

描述 [源]

final class GObject.ParamSpecString : GObject.TypeInstance
{
  default_value: gchar*,
  cset_first: gchar*,
  cset_nth: gchar*,
  substitutor: gchar,
  null_fold_if_empty: guint,
  ensure_non_null: guint
}

一个包含字符串属性元数据的衍生自 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

用于 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) 函数,该函数在调用 g_param_spec_set_qdata()(具有相同的 quark)时使用 data 作为参数。

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 中移除数据而不调用其 destroy() 函数(如果设置了)。通常,调用此函数仅需要在具有销毁通知器的用户数据指针上更新。

g_param_spec_unref

减少 pspec 的引用计数。