|  |  |  | GTK+ 3 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
#include <gtk/gtk.h> struct GtkStyleProperties; void gtk_style_properties_clear (GtkStyleProperties *props); void gtk_style_properties_get (GtkStyleProperties *props,GtkStateFlags state,...); gboolean gtk_style_properties_get_property (GtkStyleProperties *props,const gchar *property,GtkStateFlags state,GValue *value); void gtk_style_properties_get_valist (GtkStyleProperties *props,GtkStateFlags state,va_list args); GtkSymbolicColor * gtk_style_properties_lookup_color (GtkStyleProperties *props,const gchar *name); gboolean gtk_style_properties_lookup_property (const gchar *property_name,GtkStylePropertyParser *parse_func,GParamSpec **pspec); void gtk_style_properties_map_color (GtkStyleProperties *props,const gchar *name,GtkSymbolicColor *color); void gtk_style_properties_merge (GtkStyleProperties *props,const GtkStyleProperties *props_to_merge,gboolean replace); GtkStyleProperties * gtk_style_properties_new (void); gboolean (*GtkStylePropertyParser) (const gchar *string,GValue *value,GError **error); void gtk_style_properties_register_property (GtkStylePropertyParser parse_func,GParamSpec *pspec); void gtk_style_properties_set (GtkStyleProperties *props,GtkStateFlags state,...); void gtk_style_properties_set_property (GtkStyleProperties *props,const gchar *property,GtkStateFlags state,const GValue *value); void gtk_style_properties_set_valist (GtkStyleProperties *props,GtkStateFlags state,va_list args); void gtk_style_properties_unset_property (GtkStyleProperties *props,const gchar *property,GtkStateFlags state);
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.
| 
 | a GtkStyleProperties | 
void gtk_style_properties_get (GtkStyleProperties *props,GtkStateFlags state,...);
Retrieves several style property values from props for a
given state.
| 
 | a GtkStyleProperties | 
| 
 | state to retrieve the property values for | 
| 
 | property name /return value pairs, followed by NULL | 
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.
| 
 | a GtkStyleProperties | 
| 
 | style property name | 
| 
 | state to retrieve the property value for | 
| 
 | return location for the style property value. [out][transfer full] | 
| Returns : | TRUEif the property exists inprops,FALSEotherwise | 
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.
| 
 | a GtkStyleProperties | 
| 
 | state to retrieve the property values for | 
| 
 | va_list of property name/return location pairs, followed by NULL | 
Since 3.0
GtkSymbolicColor * gtk_style_properties_lookup_color (GtkStyleProperties *props,const gchar *name);
Returns the symbolic color that is mapped
to name.
| 
 | a GtkStyleProperties | 
| 
 | color name to lookup | 
| Returns : | The mapped color. [transfer none] | 
Since 3.0
gboolean gtk_style_properties_lookup_property (const gchar *property_name,GtkStylePropertyParser *parse_func,GParamSpec **pspec);
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 to look up | 
| 
 | return location for the parse function. [out] | 
| 
 | return location for the GParamSpec. [out][transfer none] | 
| Returns : | TRUEif the property is registered,FALSEotherwise | 
Since 3.0
void gtk_style_properties_map_color (GtkStyleProperties *props,const gchar *name,GtkSymbolicColor *color);
Maps color so it can be referenced by name. See
gtk_style_properties_lookup_color()
| 
 | a GtkStyleProperties | 
| 
 | color name | 
| 
 | GtkSymbolicColor to map nameto | 
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.
| 
 | a GtkStyleProperties | 
| 
 | a second GtkStyleProperties | 
| 
 | whether to replace values or not | 
Since 3.0
GtkStyleProperties * gtk_style_properties_new           (void);
Returns a newly created GtkStyleProperties
| Returns : | a new GtkStyleProperties | 
gboolean (*GtkStylePropertyParser) (const gchar *string,GValue *value,GError **error);
void gtk_style_properties_register_property (GtkStylePropertyParser parse_func,GParamSpec *pspec);
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.
| 
 | parsing function to use, or NULL | 
| 
 | the GParamSpec for the new property | 
Since 3.0
void gtk_style_properties_set (GtkStyleProperties *props,GtkStateFlags state,...);
Sets several style properties on props.
| 
 | a GtkStyleProperties | 
| 
 | state to set the values for | 
| 
 | property name/value pairs, followed by NULL | 
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.
| 
 | a GtkStyleProperties | 
| 
 | styling property to set | 
| 
 | state to set the value for | 
| 
 | 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.
| 
 | a GtkStyleProperties | 
| 
 | state to set the values for | 
| 
 | va_list of property name/value pairs, followed by NULL | 
Since 3.0
void gtk_style_properties_unset_property (GtkStyleProperties *props,const gchar *property,GtkStateFlags state);
Unsets a style property in props.
| 
 | a GtkStyleProperties | 
| 
 | property to unset | 
| 
 | state to unset | 
Since 3.0