Top |
GladePropertyGladeProperty — An interface to properties on the GladeWidget. |
Functions
Description
Every object property of every GladeWidget in every GladeProject has a GladeProperty to interface with, GladeProperty provides a means to handle properties in the runtime environment.
A GladeProperty can be seen as an instance of a GladePropertyDef, the GladePropertyDef describes how a GladeProperty will function.
Functions
glade_property_new ()
GladeProperty * glade_property_new (GladePropertyDef *def
,GladeWidget *widget
,GValue *value
);
Creates a GladeProperty of type klass
for widget
with value
; if
value
is NULL
, then the introspected default value for that property
will be used.
Parameters
def |
A GladePropertyDef defining this property |
|
widget |
The GladeWidget this property is created for |
|
value |
The initial GValue of the property or |
glade_property_dup ()
GladeProperty * glade_property_dup (GladeProperty *template_prop
,GladeWidget *widget
);
glade_property_reset ()
void
glade_property_reset (GladeProperty *property
);
Resets this property to its default value
glade_property_original_reset ()
void
glade_property_original_reset (GladeProperty *property
);
Resets this property to its original default value
glade_property_original_default ()
gboolean
glade_property_original_default (GladeProperty *property
);
glade_property_equals_value ()
gboolean glade_property_equals_value (GladeProperty *property
,const GValue *value
);
glade_property_set_value ()
gboolean glade_property_set_value (GladeProperty *property
,const GValue *value
);
Sets the property's value
glade_property_set_va_list ()
gboolean glade_property_set_va_list (GladeProperty *property
,va_list vl
);
Sets the property's value
glade_property_set ()
gboolean glade_property_set (GladeProperty *property
,...
);
Sets the property's value (in a convenient way)
glade_property_get_value ()
void glade_property_get_value (GladeProperty *property
,GValue *value
);
Retrieve the property value
glade_property_get_default ()
void glade_property_get_default (GladeProperty *property
,GValue *value
);
Retrieve the default property value
glade_property_get_va_list ()
void glade_property_get_va_list (GladeProperty *property
,va_list vl
);
Retrieve the property value
glade_property_get ()
void glade_property_get (GladeProperty *property
,...
);
Retrieve the property value
glade_property_add_object ()
void glade_property_add_object (GladeProperty *property
,GObject *object
);
Adds object
to the object list in property
.
Note: This function expects property
to be a GladeParamSpecObjects
or GParamSpecObject type property.
glade_property_remove_object ()
void glade_property_remove_object (GladeProperty *property
,GObject *object
);
Removes object
from the object list in property
.
Note: This function expects property
to be a GladeParamSpecObjects
or GParamSpecObject type property.
glade_property_sync ()
void
glade_property_sync (GladeProperty *property
);
Synchronize the object with this property
glade_property_load ()
void
glade_property_load (GladeProperty *property
);
Loads the value of property
from the corresponding object instance
glade_property_read ()
void glade_property_read (GladeProperty *property
,GladeProject *project
,GladeXmlNode *node
);
Read the value and any attributes for property
from node
, assumes
property
is being loaded for project
Note that object values will only be resolved after the project is completely loaded
Parameters
property |
a GladeProperty or NULL |
|
project |
the GladeProject |
|
node |
the GladeXmlNode to read, will either be a 'widget' node or a 'child' node for packing properties. |
glade_property_write ()
void glade_property_write (GladeProperty *property
,GladeXmlContext *context
,GladeXmlNode *node
);
Write property
to node
glade_property_set_sensitive ()
void glade_property_set_sensitive (GladeProperty *property
,gboolean sensitive
,const gchar *reason
);
glade_property_set_save_always ()
void glade_property_set_save_always (GladeProperty *property
,gboolean setting
);
Sets whether this property should be special cased to always be saved regardless of its default value. (used for some special cases like properties that are assigned initial values in composite widgets or derived widget code).
glade_property_get_save_always ()
gboolean
glade_property_get_save_always (GladeProperty *property
);
glade_property_set_enabled ()
void glade_property_set_enabled (GladeProperty *property
,gboolean enabled
);
glade_property_i18n_set_comment ()
void glade_property_i18n_set_comment (GladeProperty *property
,const gchar *str
);
glade_property_i18n_get_comment ()
const gchar *
glade_property_i18n_get_comment (GladeProperty *property
);
glade_property_i18n_set_translatable ()
void glade_property_i18n_set_translatable (GladeProperty *property
,gboolean translatable
);
glade_property_i18n_get_translatable ()
gboolean
glade_property_i18n_get_translatable (GladeProperty *property
);
glade_property_set_support_warning ()
void glade_property_set_support_warning (GladeProperty *property
,gboolean disable
,const gchar *reason
);
glade_property_set_widget ()
void glade_property_set_widget (GladeProperty *property
,GladeWidget *widget
);
glade_property_get_def ()
GladePropertyDef *
glade_property_get_def (GladeProperty *property
);
Get the GladePropertyDef this property was created for.
glade_property_get_support_warning ()
const gchar *
glade_property_get_support_warning (GladeProperty *property
);
glade_property_i18n_get_context ()
const gchar *
glade_property_i18n_get_context (GladeProperty *property
);
glade_property_i18n_set_context ()
void glade_property_i18n_set_context (GladeProperty *property
,const gchar *str
);
glade_propert_get_insensitive_tooltip ()
const gchar *
glade_propert_get_insensitive_tooltip (GladeProperty *property
);
Property Details
The “class”
property
“class” gpointer
The GladePropertyDef for this property.
Owner: GladeProperty
Flags: Read / Write / Construct Only
The “enabled”
property
“enabled” gboolean
If the property is optional, this is its enabled state.
Owner: GladeProperty
Flags: Read / Write
Default value: TRUE
The “i18n-comment”
property
“i18n-comment” gchar *
Comment for translators.
Owner: GladeProperty
Flags: Read / Write
Default value: NULL
The “i18n-context”
property
“i18n-context” gchar *
Context for translation.
Owner: GladeProperty
Flags: Read / Write
Default value: NULL
The “i18n-translatable”
property
“i18n-translatable” gboolean
Whether this property is translatable.
Owner: GladeProperty
Flags: Read / Write
Default value: TRUE
The “precision”
property
“precision” gint
Where applicable, precision to use on editors.
Owner: GladeProperty
Flags: Read / Write
Allowed values: >= 0
Default value: 2
The “sensitive”
property
“sensitive” gboolean
This gives backends control to set property sensitivity.
Owner: GladeProperty
Flags: Read / Write
Default value: TRUE
The “state”
property
“state” gint
Priority information for the property editor to act on.
Owner: GladeProperty
Flags: Read
Allowed values: >= 0
Default value: 0
Signal Details
The “tooltip-changed”
signal
void user_function (GladeProperty *gladeproperty, gchar *arg1, gchar *arg2, gchar *arg3, gpointer user_data)
Flags: Run Last
The “value-changed”
signal
void user_function (GladeProperty *gladeproperty, gpointer arg1, gpointer arg2, gpointer user_data)
Flags: Run Last