ParamSpec

---

Object Hierarchy:

Description:

Content:

Creation methods:

• public ParamSpec.internal (Type param_type, string name, string nick, string blurb, ParamFlags flags)
  Creates a new ParamSpec instance.

Methods:

• public ParamSpec ref ()
  Increments the reference count of pspec.
• public void unref ()
  Decrements the reference count of a pspec.
• public void sink ()
  The initial reference count of a newly created ParamSpec is 1, even though no one has explicitly called ref on it yet. So the initial reference count is flagged as "floating", until someone calls g_param_spec_ref (pspec); g_param_spec_sink (pspec); in sequence on it, taking over the initial reference count (thus ending up with a pspec that has a reference count of 1 still, but is not flagged "floating" anymore).
• public ParamSpec ref_sink ()
  Convenience function to ref and sink a ParamSpec.
• public void set_value_default (Value value)
  Sets value to its default value as specified in pspec.
• public bool value_defaults (Value value)
  Checks whether value contains the default value as specified in pspec.
• public bool value_validate (Value value)
  Ensures that the contents of value comply with the specifications set out by pspec . For example, a ParamSpecInt might require that integers stored in value may not be smaller than -42 and not be greater than +42. If value contains an integer outside of this range, it is modified accordingly, so the resulting value will fit into the range -42 .. +42.
• public bool value_convert (Value src_value, Value dest_value, bool strict_validation)
  Transforms src_value into dest_value if possible, and then validates dest_value, in order for it to conform to pspec. If strict_validation is true this function will only succeed if the transformed dest_value complied to pspec without modifications.
• public int values_cmp (Value value1, Value value2)
  Compares value1 with value2 according to pspec, and return -1, 0 or +1, if value1 is found to be less than, equal to or greater than value2, respectively.
• public unowned string get_blurb ()
  Get the short description of a ParamSpec.
• public unowned string get_name ()
  Get the name of a ParamSpec.
• public unowned string get_nick ()
  Get the nickname of a ParamSpec.
• public void* get_qdata (Quark quark)
  Gets back user data pointers stored via set_qdata.
• public void set_qdata (Quark quark, void* data)
  Sets an opaque, named pointer on a ParamSpec. The name is specified through a Quark (retrieved e.g. via g_quark_from_static_string), and the pointer can be gotten back from the pspec with get_qdata. Setting a previously set user data pointer, overrides (frees) the old pointer set, using null as pointer essentially removes the data stored.
• public void set_qdata_full (Quark quark, void* data, DestroyNotify destroy)
  This function works like set_qdata, but in addition, a void (*destroy) (gpointer) function may be specified which is called with data as argument when the pspec is finalized, or the data is being overwritten by a call to set_qdata with the same quark.
• public void* steal_qdata (Quark quark)
  Gets back user data pointers stored via set_qdata and removes the data from pspec without invoking its destroy function (if any was set). Usually, calling this function is only required to update user data pointers with a destroy notifier.
• public ParamSpec get_redirect_target ()
  If the paramspec redirects operations to another paramspec, returns that paramspec. Redirect is used typically for providing a new implementation of a property in a derived type while preserving all the properties from the parent type. Redirection is established by creating a property of type GParamSpecOverride. See g_object_class_override_property for an example of the use of this capability.

Fields:

• public string name
• public ParamFlags flags
• public Type value_type
• public Type owner_type