| Top |
GtkStyleProperties provides the storage for style information that is used by GtkStyleContext and other GtkStyleProvider implementations.
Before style properties can be stored in GtkStyleProperties, they
must be registered with gtk_style_properties_register_property().
Unless you are writing a GtkStyleProvider implementation, you
are unlikely to use this API directly, as gtk_style_context_get()
and its variants are the preferred way to access styling information
from widget implementations and theming engine implementations
should use the APIs provided by GtkThemingEngine instead.
void
gtk_style_properties_clear (GtkStyleProperties *props);
Clears all style information from props
.
void gtk_style_properties_get (GtkStyleProperties *props,GtkStateFlags state,...);
Retrieves several style property values from props
for a
given state.
props |
||
state |
state to retrieve the property values for |
|
... |
property name /return value pairs, followed by |
Since 3.0
gboolean gtk_style_properties_get_property (GtkStyleProperties *props,const gchar *property,GtkStateFlags state,GValue *value);
Gets a style property from props
for the given state. When done with value
,
g_value_unset() needs to be called to free any allocated memory.
props |
||
property |
style property name |
|
state |
state to retrieve the property value for |
|
value |
return location for the style property value. |
[out][transfer full] |
Since 3.0
void gtk_style_properties_get_valist (GtkStyleProperties *props,GtkStateFlags state,va_list args);
Retrieves several style property values from props
for a given state.
props |
||
state |
state to retrieve the property values for |
|
args |
va_list of property name/return location pairs, followed by |
Since 3.0
GtkSymbolicColor * gtk_style_properties_lookup_color (GtkStyleProperties *props,const gchar *name);
gtk_style_properties_lookup_color has been deprecated since version 3.8 and should not be used in newly-written code.
GtkSymbolicColor is deprecated.
Returns the symbolic color that is mapped
to name
.
Since 3.0
gboolean gtk_style_properties_lookup_property (const gchar *property_name,GtkStylePropertyParser *parse_func,GParamSpec **pspec);
gtk_style_properties_lookup_property has been deprecated since version 3.8 and should not be used in newly-written code.
This code could only look up custom properties and those are deprecated.
Returns TRUE if a property has been registered, if pspec
or
parse_func
are not NULL, the GParamSpec and parsing function
will be respectively returned.
property_name |
property name to look up |
|
parse_func |
return location for the parse function. |
[out] |
pspec |
return location for the GParamSpec. |
[out][transfer none] |
Since 3.0
void gtk_style_properties_map_color (GtkStyleProperties *props,const gchar *name,GtkSymbolicColor *color);
gtk_style_properties_map_color has been deprecated since version 3.8 and should not be used in newly-written code.
GtkSymbolicColor is deprecated.
Maps color
so it can be referenced by name
. See
gtk_style_properties_lookup_color()
Since 3.0
void gtk_style_properties_merge (GtkStyleProperties *props,const GtkStyleProperties *props_to_merge,gboolean replace);
Merges into props
all the style information contained
in props_to_merge
. If replace
is TRUE, the values
will be overwritten, if it is FALSE, the older values
will prevail.
props |
||
props_to_merge |
a second GtkStyleProperties |
|
replace |
whether to replace values or not |
Since 3.0
GtkStyleProperties *
gtk_style_properties_new (void);
Returns a newly created GtkStyleProperties
gboolean (*GtkStylePropertyParser) (const gchar *string,GValue *value,GError **error);
void gtk_style_properties_register_property (GtkStylePropertyParser parse_func,GParamSpec *pspec);
gtk_style_properties_register_property has been deprecated since version 3.8 and should not be used in newly-written code.
Code should use the default properties provided by CSS.
Registers a property so it can be used in the CSS file format.
This function is the low-level equivalent of
gtk_theming_engine_register_property(), if you are implementing
a theming engine, you want to use that function instead.
Since 3.0
void gtk_style_properties_set (GtkStyleProperties *props,GtkStateFlags state,...);
Sets several style properties on props
.
Since 3.0
void gtk_style_properties_set_property (GtkStyleProperties *props,const gchar *property,GtkStateFlags state,const GValue *value);
Sets a styling property in props
.
props |
||
property |
styling property to set |
|
state |
state to set the value for |
|
value |
new value for the property |
Since 3.0
void gtk_style_properties_set_valist (GtkStyleProperties *props,GtkStateFlags state,va_list args);
Sets several style properties on props
.
props |
||
state |
state to set the values for |
|
args |
va_list of property name/value pairs, followed by |
Since 3.0
void gtk_style_properties_unset_property (GtkStyleProperties *props,const gchar *property,GtkStateFlags state);
Unsets a style property in props
.
Since 3.0