override_color


Description:

[ Version ( deprecated = true , deprecated_since = "3.16" , since = "3.0" ) ]
public void override_color (StateFlags state, RGBA? color)

Warning: override_color is deprecated since 3.16.

Sets the color to use for a widget.

Note:

Use a custom style provider and style classes instead

All other style values are left untouched.

This function does not act recursively. Setting the color of a container does not affect its children. Note that some widgets that you may not think of as containers, for instance Buttons, are actually containers.

This API is mostly meant as a quick way for applications to change a widget appearance. If you are developing a widgets library and intend this change to be themeable, it is better done by setting meaningful CSS classes in your widget/container implementation through add_class.

This way, your widget library can install a CssProvider with the gtk_style_provider_priority_fallback priority in order to provide a default styling for those widgets that need so, and this theming may fully overridden by the user’s theme.

Note that for complex widgets this may bring in undesired results (such as uniform background color everywhere), in these cases it is better to fully style such widgets through a CssProvider with the gtk_style_provider_priority_application priority.

Parameters:

this

a Widget

state

the state for which to set the color

color

the color to assign, or null to undo the effect of previous calls to override_color




2022 vala-language.org