| 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