Trait gtk4::prelude::StyleContextExt
source · pub trait StyleContextExt: 'static {
Show 20 methods
// Required methods
fn add_class(&self, class_name: &str);
fn add_provider(&self, provider: &impl IsA<StyleProvider>, priority: u32);
fn border(&self) -> Border;
fn color(&self) -> RGBA;
fn display(&self) -> Display;
fn margin(&self) -> Border;
fn padding(&self) -> Border;
fn scale(&self) -> i32;
fn state(&self) -> StateFlags;
fn has_class(&self, class_name: &str) -> bool;
fn lookup_color(&self, color_name: &str) -> Option<RGBA>;
fn remove_class(&self, class_name: &str);
fn remove_provider(&self, provider: &impl IsA<StyleProvider>);
fn restore(&self);
fn save(&self);
fn set_display(&self, display: &impl IsA<Display>);
fn set_scale(&self, scale: i32);
fn set_state(&self, flags: StateFlags);
fn to_string(&self, flags: StyleContextPrintFlags) -> GString;
fn connect_display_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId;
}
Expand description
Required Methods§
sourcefn add_class(&self, class_name: &str)
fn add_class(&self, class_name: &str)
Adds a style class to @self, so later uses of the style context will make use of this new class for styling.
In the CSS file format, a Entry
defining a “search”
class, would be matched by:
entry.search { ... }
While any widget defining a “search” class would be matched by:
.search { ... }
Deprecated since 4.10
Use WidgetExt::add_css_class()
instead
class_name
class name to use in styling
sourcefn add_provider(&self, provider: &impl IsA<StyleProvider>, priority: u32)
fn add_provider(&self, provider: &impl IsA<StyleProvider>, priority: u32)
Adds a style provider to @self, to be used in style construction.
Note that a style provider added by this function only affects
the style of the widget to which @self belongs. If you want
to affect the style of all widgets, use
StyleContext::add_provider_for_display()
.
Note: If both priorities are the same, a StyleProvider
added through this function takes precedence over another added
through StyleContext::add_provider_for_display()
.
Deprecated since 4.10
Use style classes instead
provider
priority
the priority of the style provider. The lower
it is, the earlier it will be used in the style construction.
Typically this will be in the range between
GTK_STYLE_PROVIDER_PRIORITY_FALLBACK
and
GTK_STYLE_PROVIDER_PRIORITY_USER
sourcefn border(&self) -> Border
fn border(&self) -> Border
Gets the border for a given state as a Border
.
Deprecated since 4.10
This api will be removed in GTK 5
Returns
border
return value for the border settings
sourcefn color(&self) -> RGBA
fn color(&self) -> RGBA
Gets the foreground color for a given state.
Deprecated since 4.10
Use WidgetExt::color()
instead
Returns
color
return value for the foreground color
sourcefn display(&self) -> Display
fn display(&self) -> Display
Returns the gdk::Display
to which @self is attached.
Deprecated since 4.10
Use WidgetExt::display()
instead
Returns
a gdk::Display
.
sourcefn margin(&self) -> Border
fn margin(&self) -> Border
Gets the margin for a given state as a Border
.
Deprecated since 4.10
This api will be removed in GTK 5
Returns
margin
return value for the margin settings
sourcefn padding(&self) -> Border
fn padding(&self) -> Border
Gets the padding for a given state as a Border
.
Deprecated since 4.10
This api will be removed in GTK 5
Returns
padding
return value for the padding settings
sourcefn scale(&self) -> i32
fn scale(&self) -> i32
Returns the scale used for assets.
Returns
the scale
Deprecated 4.10: Use WidgetExt::scale_factor()
instead
sourcefn state(&self) -> StateFlags
fn state(&self) -> StateFlags
Returns the state used for style matching.
This method should only be used to retrieve the StateFlags
to pass to StyleContext
methods, like
padding()
.
If you need to retrieve the current state of a Widget
, use
WidgetExt::state_flags()
.
Deprecated since 4.10
Use WidgetExt::state_flags()
instead
Returns
the state flags
sourcefn has_class(&self, class_name: &str) -> bool
fn has_class(&self, class_name: &str) -> bool
Returns true
if @self currently has defined the
given class name.
Deprecated since 4.10
Use WidgetExt::has_css_class()
instead
class_name
a class name
Returns
true
if @self has @class_name defined
sourcefn lookup_color(&self, color_name: &str) -> Option<RGBA>
fn lookup_color(&self, color_name: &str) -> Option<RGBA>
Looks up and resolves a color name in the @self color map.
Deprecated since 4.10
This api will be removed in GTK 5
color_name
color name to lookup
Returns
true
if @color_name was found and resolved, false
otherwise
color
Return location for the looked up color
sourcefn remove_class(&self, class_name: &str)
fn remove_class(&self, class_name: &str)
Removes @class_name from @self.
Deprecated since 4.10
Use WidgetExt::remove_css_class()
instead
class_name
class name to remove
sourcefn remove_provider(&self, provider: &impl IsA<StyleProvider>)
fn remove_provider(&self, provider: &impl IsA<StyleProvider>)
sourcefn restore(&self)
fn restore(&self)
Restores @self state to a previous stage.
See save()
.
Deprecated since 4.10
This API will be removed in GTK 5
sourcefn save(&self)
fn save(&self)
Saves the @self state.
This allows temporary modifications done through
add_class()
,
remove_class()
,
set_state()
to be quickly
reverted in one go through restore()
.
The matching call to restore()
must be done before GTK returns to the main loop.
Deprecated since 4.10
This API will be removed in GTK 5
sourcefn set_display(&self, display: &impl IsA<Display>)
fn set_display(&self, display: &impl IsA<Display>)
Attaches @self to the given display.
The display is used to add style information from “global”
style providers, such as the display’s Settings
instance.
If you are using a StyleContext
returned from
WidgetExt::style_context()
, you do not need to
call this yourself.
Deprecated since 4.10
You should not use this api
display
sourcefn set_scale(&self, scale: i32)
fn set_scale(&self, scale: i32)
Sets the scale to use when getting image assets for the style.
Deprecated since 4.10
You should not use this api
scale
scale
sourcefn set_state(&self, flags: StateFlags)
fn set_state(&self, flags: StateFlags)
Sets the state to be used for style matching.
Deprecated since 4.10
You should not use this api
flags
state to represent
sourcefn to_string(&self, flags: StyleContextPrintFlags) -> GString
fn to_string(&self, flags: StyleContextPrintFlags) -> GString
Converts the style context into a string representation.
The string representation always includes information about the name, state, id, visibility and style classes of the CSS node that is backing @self. Depending on the flags, more information may be included.
This function is intended for testing and debugging of the CSS implementation in GTK. There are no guarantees about the format of the returned string, it may change.
Deprecated since 4.10
This api will be removed in GTK 5
flags
Flags that determine what to print
Returns
a newly allocated string representing @self