Property Class Definitions

Property Classes — How to augment or define a GladePropertyClass

Property Class Configuration

Properties are introspected at load time and loaded into GladePropertyClass structures. The behaviour of properties can be modified by the catalog and fake properties can be added for editing purposes. Here is an example of the xml form:

...

<property id="frobnicate-mode" default="FOO_FROBNICATE_RED">

  ... spec, tooltip etc

  <displayable-values>

    <value id="FOO_FROBNICATE_RED" name="Red"/>
    <value id="FOO_FROBNICATE_BLUE" name="Blue"/>

    ... values here

  </displayable-values>

</property>

...

Properties of the 'property' tag:

id

This is manditory and specifies the property that we are modifying (or adding)

name

The name to be used in the interface. (if name is not specified; it defaults to the nickname of the GParamSpec)

since

A 'major.minor' formed version describing the version of the owning catalog in which this property was introduced; example: since="1.0". Properties are initialized to be supported since the introducing GladeWidgetAdaptor was supported.

disabled

Remove this property from this widget class and derived classes

default

A default value to be used for this property

translatable

For text properties, whether the property value is translatable in glade interfaces (this will enable the i18n dialog on text properties). Defaults to False.

common

If set to "True", the property will end up on the common tab even if its not a property of GtkWidgetClass.

optional

Whether this property is an optional property, this will make the property insensitive and add a check box to enable it (like width/height-request for example).

optional-default

If this is in fact an optional property; whether it is enabled by default.

query

If query is set; the property will be queried from the user in a dialog when adding the owning widget class instance to the project.

save

Whether to save this property to the glade file (default "True")

visible

Whether to show the property in the editor and reset dialog (default "True")

custom-layout

This is used to avoid loading this property in the editor when implementing a custom GladeEditable that embeds the base GladeEditorTable implementation, custom-layout properties will still show up in the reset dialog (default "False)

ignore

Whether to set the property on the object instance (via g_object_set_property or plugin override functions) when it changes in the editor (the value in the editor is the value saved).

themed-icon

Depicts a string property that is used for an icon from the theme. These will the appropriate editor.

weight

A numerical value to specify this properties position in the property editor.

transfer-on-paste

Used for packing properties; depicts packing properties that should follow the widget when pasted to a new container that supports the same properties.

save-always

Specifies that the property should be saved regardless of its value (properties at thier default values are normally not saved).

Child tags of the 'property' tag:

spec

Specifies a function to be used to return a GParamSpec for this property; this is used to add virtual properties to an object (like the "size" property on GtkBox).

tooltip

The tooltip to be displayed in the property editor for this property. The tooltip defaults to the blurb of the associated GParamSpec.

visible-lines

An integer value to specify how many lines will be shown for text properties in the editor (this doesnt really work because of the complexity of calculating size of rendered text; instead, just set this to 2 if you want the text property to be edited in a textview with a scrolled window as opposed to a simple text entry).

displayable-values

Allows you to specify user friendly strings for enum and flag values as shown in the example above, use the `id' property in the value tag to depict the real value name and the `name' property for the human readable one.