Struct WidgetContext

pub struct WidgetContext<'context> { /* private fields */ }

A context for a widget.

This type provides access to the widget hierarchy from the perspective of a specific widget.

Implementations

impl<'context> WidgetContext<'context>

pub fn borrowed(&mut self) -> WidgetContext<'_>

Returns a new instance that borrows from self.

pub fn for_other<'child, Widget>( &'child mut self, widget: &Widget, ) -> <Widget::Managed as MapManagedWidget<WidgetContext<'child>>>::Result

where Widget: ManageWidget, Widget::Managed: MapManagedWidget<WidgetContext<'child>>,

Returns a new context representing widget.

pub fn is_child_of(&self, possible_parent: &WidgetInstance) -> bool

Returns true if possible_parent is in this widget’s parent list.

pub const fn enabled(&self) -> bool

Returns true if this widget is enabled.

pub fn redraw_when_changed(&self, value: &impl Trackable)

Ensures that this widget will be redrawn when value has been updated.

pub fn invalidate_when_changed(&self, value: &impl Trackable)

Ensures that this widget will be redrawn when value has been updated.

pub fn last_layout(&self) -> Option<Rect<Px>>

Returns the last layout of this widget.

pub fn focus(&mut self)

Sets the currently focused widget to this widget.

Widget events relating to focus changes are deferred until after the all contexts for the currently firing event are dropped.

pub fn blur(&mut self) -> bool

Clears focus from this widget, if it is the focused widget.

Returns true if this function resulted in the focus being changed.

Widget events relating to focus changes are deferred until after the all contexts for the currently firing event are dropped.

pub fn focus_is_advancing(&mut self) -> bool

Returns true if the last focus event was an advancing motion, not a returning motion.

This value is meaningless outside of focus-related events.

pub fn activate(&mut self) -> bool

Activates this widget, if it is not already active.

Returns true if this function resulted in the currently active widget being changed.

Widget events relating to activation changes are deferred until after the all contexts for the currently firing event are dropped.

pub fn deactivate(&mut self) -> bool

Deactivates this widget, if it is the currently active widget.

Returns true if this function resulted in the active widget being changed.

Widget events relating to activation changes are deferred until after the all contexts for the currently firing event are dropped.

pub fn active(&self) -> bool

Returns true if this widget is currently the active widget.

pub fn hovered(&self) -> bool

Returns true if this widget is currently hovered, even if the cursor is over a child widget.

pub fn primary_hover(&self) -> bool

Returns true if this widget that is directly beneath the cursor.

pub fn focused(&self, check_window: bool) -> bool

Returns true if this widget is currently focused for user input.

pub fn is_default(&self) -> bool

Returns true if this widget is the target to activate when the user triggers a default action.

See MakeWidget::into_default() for more information.

pub fn is_escape(&self) -> bool

Returns true if this widget is the target to activate when the user triggers an escape action.

See MakeWidget::into_escape() for more information.

pub const fn widget(&self) -> &MountedWidget

Returns the widget this context is for.

pub fn attach_styles(&self, styles: impl IntoValue<Styles>)

Attaches styles to the widget hierarchy for this widget.

Style queries for children will return any values matching this collection.

pub fn attach_theme(&self, theme: Value<ThemePair>)

Attaches theme to the widget hierarchy for this widget.

All children nodes will access this theme in their contexts.

pub fn attach_theme_mode(&mut self, theme_mode: Value<ThemeMode>)

Attaches theme_mode to the widget hierarchy for this widget.

All children nodes will use this theme mode.

pub fn attach_locale(&self, locale: Value<LanguageIdentifier>)

Attaches locale to the widget hierarchy for this widget.

All children nodes will access this theme in their contexts.

pub fn get<Component: ComponentDefinition>( &self, query: &Component, ) -> Component::ComponentType

Queries the widget hierarchy for a single style component.

This function traverses up the widget hierarchy looking for the component being requested. If a matching component is found, it will be returned. Otherwise, the default value will be returned.

pub fn try_get<Component: ComponentDefinition>( &self, query: &Component, ) -> Option<Component::ComponentType>

Queries the widget hierarchy for a single style component.

This function traverses up the widget hierarchy looking for the component being requested. If a matching component is found, it will be returned.

pub const fn window(&self) -> &dyn PlatformWindow

Returns the window containing this widget.

pub const fn locale(&self) -> &Value<LanguageIdentifier>

Returns the locale for this widget.

pub const fn localizations(&self) -> &Localizations

Returns the localizations for this application.

pub const fn window_mut(&mut self) -> &mut dyn PlatformWindow

Returns an exclusive reference to the window containing this widget.

pub fn theme_pair(&self) -> &ThemePair

Returns the theme pair for the window.

pub fn theme(&self) -> &Theme

Returns the current theme in either light or dark mode.

pub fn theme_mode(&self) -> ThemeMode

Returns the currently active theme mode.

pub fn inverse_theme(&self) -> &Theme

Returns the opposite theme of Self::theme().

pub fn cache_key(&self) -> WidgetCacheKey

Returns a key that can be checked to see if a widget should invalidate caches it stores.

pub fn loaded_font_faces(&self, font: &LoadedFont) -> &[LoadedFontFace]

Returns a list of faces that were loaded from font, or an empty slice if no faces were loaded.

Trait Implementations

impl<'context> Deref for WidgetContext<'context>

type Target = &'context mut dyn PlatformWindow

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for WidgetContext<'_>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl LocalizationContext for WidgetContext<'_>

fn locale(&self) -> LanguageIdentifier

Returns the current locale of this context.

fn localizations(&self) -> &Localizations

Returns the localizations for this context.

fn invalidate_when_changed(&self, trackable: &impl Trackable)

Invalidates trackable when changed.