Package: gobject

Function g-param-spec-internal

Lambda List

g-param-spec-internal (param-type name nick blurb flags)

Arguments

param-type -- the g-type for the property, must be derived from +g-type-param+
name -- a :string with the canonical name of the property
nick -- a :string with the nickname of the property
blurb -- a :string with a short description of the property
flags -- a combination of flags of type g-param-flags

Return Value

A newly allocated g-param-spec instance.

Details

Creates a new parameter specification instance.

A property name consists of segments consisting of ASCII letters and digits, separated by either the '-' or '_' character. The first character of a property name must be a letter. Names which violate these rules lead to undefined behaviour.

When creating and looking up a g-param-spec, either separator can be used, but they cannot be mixed. Using '-' is considerably more efficient and in fact required when using property names as detail strings for signals.

Beyond name, g-param-spec's have two more descriptive strings associated with them, nick, which should be suitable for use as a label for the property in a property editor, and blurb, which should be a somewhat longer description, suitable for e.g. a tooltip. nick and blurb should ideally be localized.

Examples

  (g-param-spec-internal "GParamBoolean" "Boolean" "Bool" "Doku" '(:readable :writable))
=> #.(SB-SYS:INT-SAP #X00933890)
  (g-param-spec-type-name *)
=> "GParamBoolean"    
 

See also

2020-10-10