GtkStyleProperties
GtkStyleProperties — Store for style property information
Functions
void | gtk_style_properties_clear () |
void | gtk_style_properties_get () |
gboolean | gtk_style_properties_get_property () |
void | gtk_style_properties_get_valist () |
GtkSymbolicColor * | gtk_style_properties_lookup_color () |
gboolean | gtk_style_properties_lookup_property () |
void | gtk_style_properties_map_color () |
void | gtk_style_properties_merge () |
GtkStyleProperties * | gtk_style_properties_new () |
gboolean | (*GtkStylePropertyParser) () |
void | gtk_style_properties_register_property () |
void | gtk_style_properties_set () |
void | gtk_style_properties_set_property () |
void | gtk_style_properties_set_valist () |
void | gtk_style_properties_unset_property () |
Types and Values
struct | GtkStyleProperties |
Includes
#include <gtk/gtk.h>
Description
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.
GtkStyleProperties has been deprecated in GTK 3.16. The CSS machinery does not use it anymore and all users of this object have been deprecated.
Functions
gtk_style_properties_clear ()
void
gtk_style_properties_clear (GtkStyleProperties *props
);
gtk_style_properties_clear
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
Clears all style information from props
.
Parameters
props |
gtk_style_properties_get ()
void gtk_style_properties_get (GtkStyleProperties *props
,GtkStateFlags state
,...
);
gtk_style_properties_get
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
Retrieves several style property values from props
for a given state.
Parameters
props | ||
state | state to retrieve the property values for | |
... | property name /return value pairs, followed by |
Since: 3.0
gtk_style_properties_get_property ()
gboolean gtk_style_properties_get_property (GtkStyleProperties *props
,const gchar *property
,GtkStateFlags state
,GValue *value
);
gtk_style_properties_get_property
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
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.
Parameters
props | ||
property | style property name | |
state | state to retrieve the property value for | |
value | return location for the style property value. | [out][transfer full] |
Returns
TRUE
if the property exists in props
, FALSE
otherwise
Since: 3.0
gtk_style_properties_get_valist ()
void gtk_style_properties_get_valist (GtkStyleProperties *props
,GtkStateFlags state
,va_list args
);
gtk_style_properties_get_valist
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
Retrieves several style property values from props
for a given state.
Parameters
props | ||
state | state to retrieve the property values for | |
args | va_list of property name/return location pairs, followed by |
Since: 3.0
gtk_style_properties_lookup_color ()
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
.
Parameters
props | ||
name | color name to lookup |
Returns
The mapped color.
[transfer none]
Since: 3.0
gtk_style_properties_lookup_property ()
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.
[skip]
Parameters
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] |
Returns
TRUE
if the property is registered, FALSE
otherwise
Since: 3.0
gtk_style_properties_map_color ()
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()
Parameters
props | ||
name | color name | |
color | GtkSymbolicColor to map |
Since: 3.0
gtk_style_properties_merge ()
void gtk_style_properties_merge (GtkStyleProperties *props
,const GtkStyleProperties *props_to_merge
,gboolean replace
);
gtk_style_properties_merge
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
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.
Parameters
props | ||
props_to_merge | a second GtkStyleProperties | |
replace | whether to replace values or not |
Since: 3.0
gtk_style_properties_new ()
GtkStyleProperties *
gtk_style_properties_new (void
);
gtk_style_properties_new
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
Returns a newly created GtkStyleProperties
Returns
a new GtkStyleProperties
GtkStylePropertyParser ()
gboolean (*GtkStylePropertyParser) (const gchar *string, GValue *value, GError **error);
gtk_style_properties_register_property ()
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.
[skip]
Parameters
parse_func | parsing function to use, or | [nullable] |
pspec | the GParamSpec for the new property |
Since: 3.0
gtk_style_properties_set ()
void gtk_style_properties_set (GtkStyleProperties *props
,GtkStateFlags state
,...
);
gtk_style_properties_set
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
Sets several style properties on props
.
Parameters
props | ||
state | state to set the values for | |
... | property name/value pairs, followed by |
Since: 3.0
gtk_style_properties_set_property ()
void gtk_style_properties_set_property (GtkStyleProperties *props
,const gchar *property
,GtkStateFlags state
,const GValue *value
);
gtk_style_properties_set_property
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
Sets a styling property in props
.
Parameters
props | ||
property | styling property to set | |
state | state to set the value for | |
value | new value for the property |
Since: 3.0
gtk_style_properties_set_valist ()
void gtk_style_properties_set_valist (GtkStyleProperties *props
,GtkStateFlags state
,va_list args
);
gtk_style_properties_set_valist
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
Sets several style properties on props
.
Parameters
props | ||
state | state to set the values for | |
args | va_list of property name/value pairs, followed by |
Since: 3.0
gtk_style_properties_unset_property ()
void gtk_style_properties_unset_property (GtkStyleProperties *props
,const gchar *property
,GtkStateFlags state
);
gtk_style_properties_unset_property
has been deprecated since version 3.16 and should not be used in newly-written code.
GtkStyleProperties are deprecated.
Unsets a style property in props
.
Parameters
props | ||
property | property to unset | |
state | state to unset |
Since: 3.0
Types and Values
struct GtkStyleProperties
struct GtkStyleProperties { };
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/gtk3-GtkStyleProperties.html