|  |  |  | Glade UI Builder Reference Manual |  | 
|---|---|---|---|---|
#define GPC_OBJECT_DELIMITER #define GPC_PROPERTY_NAMELEN enum GPCType; GladePropertyClass* glade_property_class_new (gpointer handle); GladePropertyClass* glade_property_class_new_from_spec (gpointer handle, GParamSpec *spec); GList* glade_property_class_list_atk_relations (gpointer handle, GType owner_type); GladePropertyClass* glade_property_class_accel_property (gpointer handle, GType owner_type); GladePropertyClass* glade_property_class_clone (GladePropertyClass *property_class); void glade_property_class_free (GladePropertyClass *property_class); gboolean glade_property_class_is_visible (GladePropertyClass *property_class); gboolean glade_property_class_is_object (GladePropertyClass *property_class); GValue* glade_property_class_make_gvalue_from_string (GladePropertyClass *property_class, const gchar *string, GladeProject *project); gchar* glade_property_class_make_string_from_gvalue (GladePropertyClass *property_class, const GValue *value); GValue* glade_property_class_make_gvalue_from_vl (GladePropertyClass *property_class, va_list vl); void glade_property_class_set_vl_from_gvalue (GladePropertyClass *klass, GValue *value, va_list vl); GValue* glade_property_class_make_gvalue (GladePropertyClass *klass, ...); void glade_property_class_get_from_gvalue (GladePropertyClass *klass, GValue *value, ...); gboolean glade_property_class_update_from_node (GladeXmlNode *node, GModule *module, GType object_type, GladePropertyClass **property_class, const gchar *domain); const gchar* glade_property_class_get_displayable_value (GladePropertyClass *klass, gint value); GtkAdjustment* glade_property_class_make_adjustment (GladePropertyClass *property_class); gboolean glade_property_class_match (GladePropertyClass *klass, GladePropertyClass *comp); gboolean glade_property_class_void_value (GladePropertyClass *klass, GValue *value); const gchar* glade_property_class_atk_realname (const gchar *atk_name);
GladePropertyClass is a structure based on a GParamSpec and parameters from the Glade catalog files and describes how properties are to be handled in Glade; it also provides an interface to convert GValue to strings and va_lists etc (back and forth).
#define GPC_PROPERTY_NAMELEN 512 /* Enough space for a property name I think */
typedef enum {
	GPC_NORMAL,
	GPC_ATK_PROPERTY,
	GPC_ATK_RELATION,
	GPC_ATK_ACTION,
	GPC_ACCEL_PROPERTY
} GPCType;
| is not an atk property | |
| is a property of an AtkImplementor object | |
| is an atk relation set property | |
| is an atk action property | |
| is an accelerator key property | 
GladePropertyClass* glade_property_class_new (gpointer handle);
| 
 | A generic pointer (i.e. a GladeWidgetClass) | 
| Returns : | a new GladePropertyClass | 
GladePropertyClass* glade_property_class_new_from_spec  (gpointer handle,
                                                         GParamSpec *spec);
| 
 | A generic pointer (i.e. a GladeWidgetClass) | 
| 
 | A GParamSpec | 
| Returns : | a newly created GladePropertyClass based on specorNULLif its unsupported. | 
GList*              glade_property_class_list_atk_relations
                                                        (gpointer handle,
                                                         GType owner_type);
| 
 | A generic pointer (i.e. a GladeWidgetClass) | 
| 
 | The GType of the owning widget class. | 
| Returns : | a GList of newly created atk relation GladePropertyClass. | 
GladePropertyClass* glade_property_class_accel_property (gpointer handle,
                                                         GType owner_type);
| 
 | A generic pointer (i.e. a GladeWidgetClass) | 
| 
 | The GType of the owning widget class. | 
| Returns : | a newly created GladePropertyClass for accelerators
         of the prescribed owner_type. | 
GladePropertyClass* glade_property_class_clone (GladePropertyClass *property_class);
| 
 | a GladePropertyClass | 
| Returns : | a new GladePropertyClass cloned from property_class | 
void glade_property_class_free (GladePropertyClass *property_class);
Frees klass and its associated memory.
| 
 | a GladePropertyClass | 
gboolean glade_property_class_is_visible (GladePropertyClass *property_class);
| 
 | A GladePropertyClass | 
| Returns : | whether or not to show this property in the editor | 
gboolean glade_property_class_is_object (GladePropertyClass *property_class);
| 
 | A GladePropertyClass | 
| Returns : | whether or not this is an object property that refers to another object in this project. | 
GValue*             glade_property_class_make_gvalue_from_string
                                                        (GladePropertyClass *property_class,
                                                         const gchar *string,
                                                         GladeProject *project);
| 
 | A GladePropertyClass | 
| 
 | a string representation of this property | 
| 
 | the glade project that the associated property belongs to. | 
| Returns : | A GValue created based on the property_classandstringcriteria. | 
gchar*              glade_property_class_make_string_from_gvalue
                                                        (GladePropertyClass *property_class,
                                                         const GValue *value);
| 
 | A GladePropertyClass | 
| 
 | A GValue | 
| Returns : | A newly allocated string representation of value | 
GValue*             glade_property_class_make_gvalue_from_vl
                                                        (GladePropertyClass *property_class,
                                                         va_list vl);
| 
 | A GladePropertyClass | 
| 
 | a va_list holding one argument of the correct type
     specified by property_class | 
| Returns : | A GValue created based on the property_classand avlarg of the correct type. | 
void                glade_property_class_set_vl_from_gvalue
                                                        (GladePropertyClass *klass,
                                                         GValue *value,
                                                         va_list vl);
Sets vl from value based on klass criteria.
| 
 | A GladePropertyClass | 
| 
 | A GValue to set | 
| 
 | a va_list holding one argument of the correct type
     specified by klass | 
GValue*             glade_property_class_make_gvalue    (GladePropertyClass *klass,
                                                         ...);
| 
 | A GladePropertyClass | 
| 
 | an argument of the correct type specified by property_class | 
| Returns : | A GValue created based on the property_classand the provided argument. | 
void                glade_property_class_get_from_gvalue
                                                        (GladePropertyClass *klass,
                                                         GValue *value,
                                                         ...);
Assignes the provided return location to value
| 
 | A GladePropertyClass | 
| 
 | A GValue to set | 
| 
 | a return location of the correct type | 
gboolean            glade_property_class_update_from_node
                                                        (GladeXmlNode *node,
                                                         GModule *module,
                                                         GType object_type,
                                                         GladePropertyClass **property_class,
                                                         const gchar *domain);
Updates the property_class with the contents of the node in the xml
file. Only the values found in the xml file are overridden.
| 
 | the property node | 
| 
 | a GModule to lookup symbols from the plugin | 
| 
 | the GType of the owning object | 
| 
 | a pointer to the property class | 
| 
 | the domain to translate catalog strings from | 
| Returns : | TRUEon success.property_classis set to NULL if the property
         has Disabled="TRUE". | 
const gchar*        glade_property_class_get_displayable_value
                                                        (GladePropertyClass *klass,
                                                         gint value);
Search a displayable values for value in this property class.
| 
 | the property class to search in | 
| 
 | the value to search | 
| Returns : | a (gchar *) if a diplayable value was found, otherwise NULL. | 
GtkAdjustment*      glade_property_class_make_adjustment
                                                        (GladePropertyClass *property_class);
Creates and appropriate GtkAdjustment for use in the editor
| 
 | a pointer to the property class | 
| Returns : | An appropriate GtkAdjustment for use in the Property editor | 
gboolean            glade_property_class_match          (GladePropertyClass *klass,
                                                         GladePropertyClass *comp);
| 
 | a GladePropertyClass | 
| 
 | a GladePropertyClass | 
| Returns : | whether klassandcompare a match or not
         (properties in seperate decendant heirarchies that
          have the same name are not matches). | 
gboolean            glade_property_class_void_value     (GladePropertyClass *klass,
                                                         GValue *value);
| 
 | a GladePropertyClass | 
| 
 | |
| Returns : | Whether valuefor thisklassis voided; a voided value
         can be aNULLvalue for boxed or object type param specs. |