Gtk.StyleProperties¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37), Gtk.StyleProvider (3)
Structs:: GObject.ObjectClass (5)

class	`new` ()
	`clear` ()
	`get_property` (property, state)
	`lookup_color` (name)
	`map_color` (name, color)
	`merge` (props_to_merge, replace)
	`set_property` (property, state, value)
	`unset_property` (property, state)

Virtual Methods¶

Inherited:: GObject.Object (7), Gtk.StyleProvider (3)

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent_object	`GObject.Object`	r

Class Details¶

class Gtk.StyleProperties(**kwargs)¶

Bases:: GObject.Object, Gtk.StyleProvider
Abstract:: No
Structure:: Gtk.StylePropertiesClass

Gtk.StyleProperties provides the storage for style information that is used by Gtk.StyleContext and other Gtk.StyleProvider implementations.

Before style properties can be stored in Gtk.StyleProperties, they must be registered with gtk_style_properties_register_property().

Unless you are writing a Gtk.StyleProvider 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 Gtk.ThemingEngine instead.

Gtk.StyleProperties has been deprecated in GTK 3.16. The CSS machinery does not use it anymore and all users of this object have been deprecated.

classmethod new()[source]¶

Returns:: a new Gtk.StyleProperties
Return type:: Gtk.StyleProperties

Returns a newly created Gtk.StyleProperties

Deprecated since version 3.16: Gtk.StyleProperties are deprecated.

clear()[source]¶: Clears all style information from self.

Deprecated since version 3.16: Gtk.StyleProperties are deprecated.

get_property(property, state)[source]¶

Parameters:

property (str) – style property name
state (Gtk.StateFlags) – state to retrieve the property value for

Returns:

True if the property exists in self, False otherwise

value:: return location for the style property value.

Return type:

(bool, value: GObject.Value)

Gets a style property from self for the given state. When done with value, GObject.Value.unset() needs to be called to free any allocated memory.

New in version 3.0.

Deprecated since version 3.16: Gtk.StyleProperties are deprecated.

lookup_color(name)[source]¶

Parameters:: name (str) – color name to lookup
Returns:: The mapped color
Return type:: Gtk.SymbolicColor

Returns the symbolic color that is mapped to name.

New in version 3.0.

Deprecated since version 3.8: Gtk.SymbolicColor is deprecated.

map_color(name, color)[source]¶

Parameters:

name (str) – color name
color (Gtk.SymbolicColor) – Gtk.SymbolicColor to map name to

Maps color so it can be referenced by name. See Gtk.StyleProperties.lookup_color()

New in version 3.0.

Deprecated since version 3.8: Gtk.SymbolicColor is deprecated.

merge(props_to_merge, replace)[source]¶

Parameters:

props_to_merge (Gtk.StyleProperties) – a second Gtk.StyleProperties
replace (bool) – whether to replace values or not

Merges into self 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.

New in version 3.0.

Deprecated since version 3.16: Gtk.StyleProperties are deprecated.

set_property(property, state, value)[source]¶

Parameters:

property (str) – styling property to set
state (Gtk.StateFlags) – state to set the value for
value (GObject.Value) – new value for the property

Sets a styling property in self.

New in version 3.0.

Deprecated since version 3.16: Gtk.StyleProperties are deprecated.

unset_property(property, state)[source]¶

Parameters:

property (str) – property to unset
state (Gtk.StateFlags) – state to unset

Unsets a style property in self.

New in version 3.0.

Deprecated since version 3.16: Gtk.StyleProperties are deprecated.