![]() |
![]() |
![]() |
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.
|
a MxStyle |
|
filename of the style sheet to load |
|
a GError or NULL |
Returns : |
TRUE if the style information was loaded successfully. Returns FALSE on error. |
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
|
"changed"
signalvoid user_function (MxStyle *arg0,
gpointer user_data) : Run Last
Indicates that the style data has changed in some way. For example, a new stylesheet may have been loaded.
|
user data set when the signal handler was connected. |