| Mx Toolkit Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Signals | ||||
enum MxStyleError; struct MxStyle; struct MxStyleClass; MxStyle * mx_style_get_default (void); MxStyle * mx_style_new (void); gboolean mx_style_load_from_file (MxStyle *style,const gchar *filename,GError **error); void mx_style_get_property (MxStyle *style,MxStylable *stylable,GParamSpec *pspec,GValue *value); void mx_style_get (MxStyle *style,MxStylable *stylable,const gchar *first_property_name,...); void mx_style_get_valist (MxStyle *style,MxStylable *stylable,const gchar *first_property_name,va_list va_args);
MxStyle is a property data store that can read properties from a style sheet. It is queried with objects that implement the MxStylable interface.
typedef enum {
/*< prefix=MX_STYLE_ERROR >*/
MX_STYLE_ERROR_INVALID_FILE
} MxStyleError;
struct MxStyle;
The contents of this structure is private and should only be accessed using the provided API.
struct MxStyleClass {
GObjectClass parent_class;
void (* changed) (MxStyle *style);
/* padding for future expansion */
void (*_padding_0) (void);
void (*_padding_1) (void);
void (*_padding_2) (void);
void (*_padding_3) (void);
void (*_padding_4) (void);
};
MxStyle * mx_style_get_default (void);
Return the default MxStyle object. This includes the current theme (if any).
Returns : |
a MxStyle object. This must not be freed or unref'd by applications. [transfer none] |
MxStyle * mx_style_new (void);
Creates a new MxStyle object. This must be freed using g_object_unref when no longer required.
Returns : |
a newly allocated MxStyle |
gboolean mx_style_load_from_file (MxStyle *style,const gchar *filename,GError **error);
Load style information from the specified file.
void mx_style_get_property (MxStyle *style,MxStylable *stylable,GParamSpec *pspec,GValue *value);
Requests the property described in pspec for the specified stylable
|
the style data store object |
|
a stylable to retreive the data for |
|
a GParamSpec describing the property required |
|
a GValue to place the return value in. [out] |
void mx_style_get (MxStyle *style,MxStylable *stylable,const gchar *first_property_name,...);
Gets the style properties for stylable from style.
In general, a copy is made of the property contents and the caller is responsible for freeing the memory in the appropriate manner for the property type.
|
a MxStyle |
|
a MxStylable |
|
name of the first property to get |
|
return location for the first property, followed optionally
by more name/return location pairs, followed by NULL
|
void mx_style_get_valist (MxStyle *style,MxStylable *stylable,const gchar *first_property_name,va_list va_args);
Gets the style properties for stylable from style.
Please refer to mx_style_get() for further information.
|
a MxStyle |
|
a MxStylable |
|
name of the first property to get |
|
return location for the first property, followed optionally
by more name/return location pairs, followed by NULL
|