![]() |
![]() |
![]() |
Glade UI Builder Reference Manual | ![]() |
---|---|---|---|---|
GladePropertyGladeProperty — An interface to properties on the GladeWidget |
#include <glade.h> struct GladeProperty; GladeProperty* glade_property_new (GladePropertyClass *klass, GladeWidget *widget, GValue *value); GladeProperty* glade_property_dup (GladeProperty *template_prop, GladeWidget *widget); void glade_property_reset (GladeProperty *property); gboolean glade_property_default (GladeProperty *property); gboolean glade_property_equals_value (GladeProperty *property, const GValue *value); gboolean glade_property_equals (GladeProperty *property, ...); void glade_property_set_value (GladeProperty *property, const GValue *value); void glade_property_set_va_list (GladeProperty *property, va_list vl); void glade_property_set (GladeProperty *property, ...); void glade_property_get_value (GladeProperty *property, GValue *value); void glade_property_get_default (GladeProperty *property, GValue *value); void glade_property_get_va_list (GladeProperty *property, va_list vl); void glade_property_get (GladeProperty *property, ...); void glade_property_add_object (GladeProperty *property, GObject *object); void glade_property_remove_object (GladeProperty *property, GObject *object); void glade_property_sync (GladeProperty *property); void glade_property_load (GladeProperty *property); GValue* glade_property_read (GladeProperty *property, GladePropertyClass *pclass, GladeProject *project, gpointer info, gboolean free_value); gboolean glade_property_write (GladeProperty *property, GladeInterface *interface, GArray *props); gboolean glade_property_superuser (void); void glade_property_push_superuser (void); void glade_property_pop_superuser (void); const gchar* glade_property_get_tooltip (GladeProperty *property); void glade_property_set_sensitive (GladeProperty *property, gboolean sensitive, const gchar *reason); gboolean glade_property_get_sensitive (GladeProperty *property); void glade_property_set_enabled (GladeProperty *property, gboolean enabled); gboolean glade_property_get_enabled (GladeProperty *property); void glade_property_i18n_set_comment (GladeProperty *property, const gchar *str); const gchar* glade_property_i18n_get_comment (GladeProperty *property); void glade_property_i18n_set_translatable (GladeProperty *property, gboolean translatable); gboolean glade_property_i18n_get_translatable (GladeProperty *property); void glade_property_i18n_set_has_context (GladeProperty *property, gboolean has_context); gboolean glade_property_i18n_get_has_context (GladeProperty *property);
"enabled" gboolean : Read / Write "i18n-comment" gchararray : Read / Write "i18n-has-context" gboolean : Read / Write "i18n-translatable" gboolean : Read / Write "sensitive" gboolean : Read / Write
"tooltip-changed" void user_function (GladeProperty *gladeproperty, gpointer arg1, gpointer user_data) : Run last "value-changed" void user_function (GladeProperty *gladeproperty, gpointer arg1, gpointer arg2, gpointer user_data) : Run last
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 GladePropertyClass, the GladePropertyClass describes how a GladeProperty will function.
GladeProperty* glade_property_new (GladePropertyClass *klass, 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.
klass : |
A GladePropertyClass defining this property |
widget : |
The GladeWidget this property is created for |
value : |
The initial GValue of the property or NULL
(the GladeProperty will assume ownership of value )
|
Returns : | The newly created GladeProperty |
GladeProperty* glade_property_dup (GladeProperty *template_prop, GladeWidget *widget);
template_prop : |
A GladeProperty |
widget : |
A GladeWidget |
Returns : | A newly duplicated property based on the new widget |
void glade_property_reset (GladeProperty *property);
Resets this property to its default value
property : |
A GladeProperty |
gboolean glade_property_default (GladeProperty *property);
property : |
A GladeProperty |
Returns : | Whether this property is at its default value |
gboolean glade_property_equals_value (GladeProperty *property, const GValue *value);
property : |
a GladeProperty |
value : |
a GValue |
Returns : | Whether this property is equal to the value provided |
gboolean glade_property_equals (GladeProperty *property, ...);
property : |
a GladeProperty |
... : |
a provided property value |
Returns : | Whether this property is equal to the value provided |
void glade_property_set_value (GladeProperty *property, const GValue *value);
Sets the property's value
property : |
a GladeProperty |
value : |
a GValue |
void glade_property_set_va_list (GladeProperty *property, va_list vl);
Sets the property's value
property : |
a GladeProperty |
vl : |
a va_list with value to set |
void glade_property_set (GladeProperty *property, ...);
Sets the property's value (in a convenient way)
property : |
a GladeProperty |
... : |
the value to set |
void glade_property_get_value (GladeProperty *property, GValue *value);
Retrieve the property value
property : |
a GladeProperty |
value : |
a GValue |
void glade_property_get_default (GladeProperty *property, GValue *value);
Retrieve the default property value
property : |
a GladeProperty |
value : |
a GValue |
void glade_property_get_va_list (GladeProperty *property, va_list vl);
Retrieve the property value
property : |
a GladeProperty |
vl : |
a va_list |
void glade_property_get (GladeProperty *property, ...);
Retrieve the property value
property : |
a GladeProperty |
... : |
An address to store the value |
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.
property : |
a GladeProperty |
object : |
The GObject to add |
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.
property : |
a GladeProperty |
object : |
The GObject to add |
void glade_property_sync (GladeProperty *property);
Synchronize the object with this property
property : |
a GladeProperty |
void glade_property_load (GladeProperty *property);
Loads the value of property
from the coresponding object instance
property : |
a GladeProperty |
GValue* glade_property_read (GladeProperty *property, GladePropertyClass *pclass, GladeProject *project, gpointer info, gboolean free_value);
Read the value and any attributes for property
from info
, assumes
property
is being loaded for project
property : |
a GladeProperty or NULL |
pclass : |
the GladePropertyClass |
project : |
the GladeProject |
info : |
a GladeWidgetInfo struct or a GladeChildInfo struct if a packing property is passed. |
free_value : |
Whether the return value should be freed after applying it to the property or if it should be returned in tact. |
Returns : | The newly created GValue if successfull (and if free_value == FALSE)
Note that object values will only be resolved after the project is
completely loaded
|
gboolean glade_property_write (GladeProperty *property, GladeInterface *interface, GArray *props);
Write this property to the GladeInterface metadata
property : |
a GladeProperty |
interface : |
a GladeInterface |
props : |
a GArray of GladePropInfo |
Returns : |
const gchar* glade_property_get_tooltip (GladeProperty *property);
property : |
a GladeProperty |
Returns : | The appropriate tooltip for the editor |
void glade_property_set_sensitive (GladeProperty *property, gboolean sensitive, const gchar *reason);
property : |
|
sensitive : |
|
reason : |
gboolean glade_property_get_sensitive (GladeProperty *property);
property : |
|
Returns : |
void glade_property_set_enabled (GladeProperty *property, gboolean enabled);
property : |
|
enabled : |
gboolean glade_property_get_enabled (GladeProperty *property);
property : |
|
Returns : |
void glade_property_i18n_set_comment (GladeProperty *property, const gchar *str);
property : |
|
str : |
const gchar* glade_property_i18n_get_comment (GladeProperty *property);
property : |
|
Returns : |
void glade_property_i18n_set_translatable (GladeProperty *property, gboolean translatable);
property : |
|
translatable : |
gboolean glade_property_i18n_get_translatable (GladeProperty *property);
property : |
|
Returns : |
void glade_property_i18n_set_has_context (GladeProperty *property, gboolean has_context);
property : |
|
has_context : |
gboolean glade_property_i18n_get_has_context (GladeProperty *property);
property : |
|
Returns : |
enabled
" property"enabled" gboolean : Read / Write
If the property is optional, this is its enabled state.
Default value: TRUE
i18n-comment
" property"i18n-comment" gchararray : Read / Write
Comment for translators.
Default value: NULL
i18n-has-context
" property"i18n-has-context" gboolean : Read / Write
Whether or not the translatable string has a context prefix.
Default value: FALSE
i18n-translatable
" property"i18n-translatable" gboolean : Read / Write
Whether this property is translatable or not.
Default value: TRUE
void user_function (GladeProperty *gladeproperty, gpointer arg1, gpointer user_data) : Run last
gladeproperty : |
the object which received the signal. |
arg1 : |
|
user_data : |
user data set when the signal handler was connected. |
void user_function (GladeProperty *gladeproperty, gpointer arg1, gpointer arg2, gpointer user_data) : Run last
gladeproperty : |
the object which received the signal. |
arg1 : |
|
Param3 : |
|
user_data : |
user data set when the signal handler was connected. |