Struct zng :: focus :: FocusableMix Copy item path

impl FocusableMix
where P: WidgetImpl,

pub fn focusable(&self, focusable: impl IntoVar<bool>)

P Makes the widget focusable when set to true.

impl FocusableMix
where P: WidgetImpl,

pub fn is_focused(&self, state: impl IntoVar<bool>)

P If the widget has keyboard focus.

This is only true if the widget itself is focused. Use is_focus_within to include focused widgets inside this one.

§Highlighting

This property is always true when the widget has focus, independent of what device moved the focus, usually when the keyboard is used a special visual indicator is rendered, a dotted line border is common, this state is called highlighting and is tracked by the focus manager. To implement such a visual you can use the is_focused_hgl property.

§Return Focus

Usually widgets that have a visual state for this property also have one for is_return_focus, a common example is the text-input widget that shows an emphasized border and blinking cursor when focused and still shows the emphasized border without cursor when a menu is open and it is only the return focus.

impl FocusableMix
where P: WidgetImpl,

pub fn is_focus_within(&self, state: impl IntoVar<bool>)

P If the widget or one of its descendants has keyboard focus.

To check if only the widget has keyboard focus use is_focused.

To track highlighted focus within use is_focus_within_hgl property.

impl FocusableMix
where P: WidgetImpl,

pub fn is_focused_hgl(&self, state: impl IntoVar<bool>)

P If the widget has keyboard focus and the user is using the keyboard to navigate.

This is only true if the widget itself is focused and the focus was acquired by keyboard navigation. You can use is_focus_within_hgl to include widgets inside this one.

§Highlighting

Usually when the keyboard is used to move the focus a special visual indicator is rendered, a dotted line border is common, this state is called highlighting and is tracked by the focus manager, this property is only true.

impl FocusableMix
where P: WidgetImpl,

pub fn is_focus_within_hgl(&self, state: impl IntoVar<bool>)

P If the widget or one of its descendants has keyboard focus and the user is using the keyboard to navigate.

To check if only the widget has keyboard focus use is_focused_hgl.

Also see is_focus_within to check if the widget has focus within regardless of highlighting.

impl FocusableMix
where P: WidgetImpl,

pub fn is_return_focus(&self, state: impl IntoVar<bool>)

P If the widget will be focused when a parent scope is focused.

Focus scopes can remember the last focused widget inside, the focus returns to this widget when the scope receives focus. Alt scopes also remember the widget from which the alt focus happened and can also return focus back to that widget.

Usually input widgets that have a visual state for is_focused also have a visual for this, a common example is the text-input widget that shows an emphasized border and blinking cursor when focused and still shows the emphasized border without cursor when a menu is open and it is only the return focus.

Note that a widget can be is_focused and is_return_focus, this property is true if any focus scope considers the widget its return focus, you probably want to declare the widget visual states in such a order that is_focused overrides the state of this property.

impl FocusableMix
where P: WidgetImpl,

pub fn is_return_focus_within(&self, state: impl IntoVar<bool>)

P If the widget or one of its descendants will be focused when a focus scope is focused.

To check if only the widget is the return focus use is_return_focus.

impl FocusableMix
where P: WidgetImpl,

pub fn focus_on_init(&self, enabled: impl IntoVar<bool>)

P If the widget is focused on info init.

When the widget is inited and present in the info tree a FOCUS.focus_widget_or_related request is made for the widget.

impl FocusableMix
where P: WidgetImpl,

pub fn return_focus_on_deinit(&self, enabled: impl IntoVar<bool>)

P If the widget return focus to the previous focus when it inited.

This can be used with the modal property to declare modal dialogs that return the focus to the widget that opens the dialog.

Consider using focus_click_behavior if the widget is also an ALT focus scope.

impl FocusableMix
where P: WidgetImpl,

pub fn focus_highlight( &self, offsets: impl IntoVar<SideOffsets>, widths: impl IntoVar<SideOffsets>, sides: impl IntoVar<BorderSides>, )

P Sets the foreground highlight values used when the widget is focused and highlighted.

Trait Implementations§

impl Deref for FocusableMix

type Target = P

The resulting type after dereferencing.

fn deref(&self) -> &<FocusableMix as Deref>::Target

Dereferences the value.

impl DerefMut for FocusableMix

fn deref_mut(&mut self) -> &mut <FocusableMix as Deref>::Target

Mutably dereferences the value.

Auto Trait Implementations§

impl UnwindSafe for FocusableMix
where P: UnwindSafe,

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> Downcast for T
where T: Any,

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.

impl<T> DowncastSync for T
where T: Any + Send + Sync,

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more