Struct StyleManager

pub struct StyleManager { /* private fields */ }

A class for managing application-wide styling.

StyleManager provides a way to query and influence the application styles, such as whether to use dark style, the system accent color or high contrast appearance.

It allows to set the color scheme via the color-scheme property, and to query the current appearance, as well as whether a system-wide color scheme and accent color preferences exists.

Properties

accent-color

The current system accent color.

See also accent-color-rgba.

Readable

accent-color-rgba

The current system accent color as a gdk::RGBA.

Equivalent to calling to_rgba() on the value of accent-color.

This is a background color. The matching foreground color is white.

Readable

color-scheme

The requested application color scheme.

The effective appearance will be decided based on the application color scheme and the system preferred color scheme. The dark property can be used to query the current effective appearance.

The ADW_COLOR_SCHEME_PREFER_LIGHT color scheme results in the application using light appearance unless the system prefers dark colors. This is the default value.

The ADW_COLOR_SCHEME_PREFER_DARK color scheme results in the application using dark appearance, but can still switch to the light appearance if the system can prefers it, for example, when the high contrast preference is enabled.

The ADW_COLOR_SCHEME_FORCE_LIGHT and ADW_COLOR_SCHEME_FORCE_DARK values ignore the system preference entirely. They are useful if the application wants to match its UI to its content or to provide a separate color scheme switcher.

If a per-gdk::Display style manager has its color scheme set to ADW_COLOR_SCHEME_DEFAULT, it will inherit the color scheme from the default style manager.

For the default style manager, ADW_COLOR_SCHEME_DEFAULT is equivalent to ADW_COLOR_SCHEME_PREFER_LIGHT.

The system-supports-color-schemes property can be used to check if the current environment provides a color scheme preference.

Readable | Writeable

dark

Whether the application is using dark appearance.

This property can be used to query the current appearance, as requested via color-scheme.

Readable

display

The display the style manager is associated with.

The display will be NULL for the style manager returned by get_default().

Readable | Writeable | Construct Only

high-contrast

Whether the application is using high contrast appearance.

This cannot be overridden by applications.

Readable

system-supports-accent-colors

Whether the system supports accent colors.

This property can be used to check if the current environment provides an accent color preference. For example, applications might want to show a preference for choosing accent color if it’s set to FALSE.

See accent-color.

Readable

system-supports-color-schemes

Whether the system supports color schemes.

This property can be used to check if the current environment provides a color scheme preference. For example, applications might want to show a separate appearance switcher if it’s set to FALSE.

See color-scheme.

Readable

Implements

[trait@glib::ObjectExt]

GLib type: GObject with reference counted clone semantics.

Implementations

impl StyleManager

pub fn accent_color(&self) -> AccentColor

Available on crate feature v1_6 only.

Gets the current system accent color.

See also accent-color-rgba.

Returns

the current system accent color

pub fn accent_color_rgba(&self) -> RGBA

Available on crate feature v1_6 only.

Gets the current system accent color as a gdk::RGBA.

Equivalent to calling to_rgba() on the value of accent-color.

This is a background color. The matching foreground color is white.

Returns

the current system accent color

pub fn color_scheme(&self) -> ColorScheme

Gets the requested application color scheme.

Returns

the color scheme

pub fn is_dark(&self) -> bool

Gets whether the application is using dark appearance.

This can be used to query the current appearance, as requested via color-scheme.

Returns

whether the application is using dark appearance

pub fn display(&self) -> Option<Display>

Gets the display the style manager is associated with.

The display will be NULL for the style manager returned by get_default().

Returns

the display

pub fn is_high_contrast(&self) -> bool

Gets whether the application is using high contrast appearance.

This cannot be overridden by applications.

Returns

whether the application is using high contrast appearance

pub fn is_system_supports_accent_colors(&self) -> bool

Available on crate feature v1_6 only.

Gets whether the system supports accent colors.

This can be used to check if the current environment provides an accent color preference. For example, applications might want to show a preference for choosing accent color if it’s set to FALSE.

See accent-color.

Returns

whether the system supports accent colors

pub fn system_supports_color_schemes(&self) -> bool

Gets whether the system supports color schemes.

This can be used to check if the current environment provides a color scheme preference. For example, applications might want to show a separate appearance switcher if it’s set to FALSE.

Returns

whether the system supports color schemes

pub fn set_color_scheme(&self, color_scheme: ColorScheme)

Sets the requested application color scheme.

The effective appearance will be decided based on the application color scheme and the system preferred color scheme. The dark property can be used to query the current effective appearance.

The ADW_COLOR_SCHEME_PREFER_LIGHT color scheme results in the application using light appearance unless the system prefers dark colors. This is the default value.

The ADW_COLOR_SCHEME_PREFER_DARK color scheme results in the application using dark appearance, but can still switch to the light appearance if the system can prefers it, for example, when the high contrast preference is enabled.

The ADW_COLOR_SCHEME_FORCE_LIGHT and ADW_COLOR_SCHEME_FORCE_DARK values ignore the system preference entirely. They are useful if the application wants to match its UI to its content or to provide a separate color scheme switcher.

If a per-gdk::Display style manager has its color scheme set to ADW_COLOR_SCHEME_DEFAULT, it will inherit the color scheme from the default style manager.

For the default style manager, ADW_COLOR_SCHEME_DEFAULT is equivalent to ADW_COLOR_SCHEME_PREFER_LIGHT.

The system-supports-color-schemes property can be used to check if the current environment provides a color scheme preference.

color_scheme

the color scheme

pub fn default() -> StyleManager

Gets the default StyleManager instance.

It manages all gdk::Display instances unless the style manager for that display has an override.

See get_for_display().

Returns

the default style manager

pub fn for_display(display: &Display) -> StyleManager

Gets the StyleManager instance managing @display.

It can be used to override styles for that specific display instead of the whole application.

Most applications should use get_default() instead.

display

a gdk::Display

Returns

the style manager for @display

pub fn connect_accent_color_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_6 only.

pub fn connect_accent_color_rgba_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_6 only.

pub fn connect_color_scheme_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_dark_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_high_contrast_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_system_supports_accent_colors_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_6 only.

pub fn connect_system_supports_color_schemes_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Trait Implementations

impl Clone for StyleManager

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StyleManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for StyleManager

type ParamSpec = ParamSpecObject

type SetValue = StyleManager

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, StyleManager>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for StyleManager

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for StyleManager

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl ParentClassIs for StyleManager

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for StyleManager

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for StyleManager

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for StyleManager

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for StyleManager