zng_wgt_toggle

Struct Toggle

source
pub struct Toggle(/* private fields */);
Expand description

W A toggle button that flips a bool or Option<bool> variable on click, or selects a value.

This widget has three primary properties, checked, checked_opt and value, setting one of the checked properties to a read-write variable enables the widget and it will set the variables on click, setting value turns the toggle in a selection item that is inserted/removed in a contextual selector.

Implementations§

source§

impl Toggle

source

pub fn widget_new() -> Self

Start building a new instance.

source

pub fn widget_type() -> WidgetType

Gets the widget type info.

source§

impl Toggle

source

pub fn style_fn(&self, style_fn: impl IntoVar<StyleFn>)

P Extends or replaces the widget style.

Properties and when conditions in the style are applied to the widget. Style instances extend the contextual style by default, you can set replace on a style to true to fully replace.

source§

impl Toggle

source

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

P Toggle cycles between true and false, updating the variable.

Note that you can read the checked state of the widget using is_checked.

source§

impl Toggle

source

pub fn checked_opt(&self, checked: impl IntoVar<Option<bool>>)

P Toggle cycles between Some(true) and Some(false) and accepts None, if the widget is tristate also sets to None in the toggle cycle.

source§

impl Toggle

source

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

P Enables None as an input value.

Note that None is always accepted in checked_opt, this property controls if None is one of the values in the toggle cycle. If the widget is bound to the checked property this config is ignored.

This is not enabled by default.

source§

impl Toggle

source

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

P If the toggle is checked from any of the three primary properties.

Note to read the tristate directly use IS_CHECKED_VAR directly.

source§

impl Toggle

source

pub fn value<T: VarValue>(&self, value: impl IntoVar<T>)

P Values that is selected in the contextual selector.

The widget is_checked when the value is selected, on click and on value update, the selection is updated according to the behavior defined in the contextual selector. If no contextual selector is the widget is never checked.

Note that the value can be any type, but must be one of the types accepted by the contextual selector, type validation happens in run-time, an error is logged if the type is not compatible. Because any type can be used in this property type inference cannot resolve the type automatically and a type annotation is required: value<T> = t;.

This property interacts with the contextual selector, when the widget is clicked or the value variable changes the contextual Selector is used to implement the behavior.

source§

impl Toggle

source

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

P If the scrolls into view when the value selected.

This is enabled by default.

source§

impl Toggle

source

pub fn selector(&self, selector: impl IntoValue<Selector>)

P Sets the contextual selector that all inner widgets will target from the value property.

All value properties declared in widgets inside child will use the Selector to manipulate the selection.

Selection in a context can be blocked by setting the selector to Selector::nil(), this is also the default selector so the value property only works if a contextual selector is present.

This property sets the SELECTOR context and handles cmd::SelectOp requests. It also sets the widget access role to AccessRole::RadioGroup.

source§

impl Toggle

source

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

P If value is selected when the widget that has the value is inited.

source§

impl Toggle

source

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

P If value is deselected when the widget that has the value is deinited and the value was selected.

source§

impl Toggle

source

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

P If value selects the new value when the variable changes and the previous value was selected.

source§

impl Toggle

source

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

P If value deselects the previously selected value when the variable changes.

source§

impl Toggle

source

pub fn checked_popup(&self, popup: impl IntoVar<WidgetFn<()>>)

P Popup open when the toggle button is checked.

This property can be used together with the ComboStyle! to implement a combo-box flyout widget.

The popup can be any widget, that will be open using POPUP, a Popup! or derived widget is recommended.

Note that if the checked property is not set the toggle will never be checked, to implement a drop-down menu set checked = var(false);.

Methods from Deref<Target = Button>§

source

pub fn on_click(&self, handler: impl WidgetHandler<ClickArgs>)

P Button click event.

source

pub fn capture_pointer(&self, mode: impl IntoVar<CaptureMode>)

P If pointer interaction with other widgets is blocked while the button is pressed.

Enabled by default in this widget.

source

pub fn style_fn(&self, style_fn: impl IntoVar<StyleFn>)

P Extends or replaces the widget style.

Properties and when conditions in the style are applied to the widget. Style instances extend the contextual style by default, you can set replace on a style to true to fully replace.

source

pub fn cmd(&self, cmd: impl IntoVar<Command>)

c Sets the Command the button represents.

When this is set the button widget sets these properties if they are not set:

  • child: Set to a widget produced by cmd_child_fn, by default is Text!(cmd.name()).
  • tooltip_fn: Set to a widget function provided by cmd_tooltip_fn, by default it shows the command info and first shortcut.
  • enabled: Set to cmd.is_enabled().
  • visibility: Set to cmd.has_handlers().into().
  • on_click: Set to a handler that notifies the command if cmd.is_enabled().
  • on_disabled_click: Set to a handler that notifies the command if !cmd.is_enabled().
source

pub fn cmd_param<T>(&self, cmd_param: impl IntoVar<T>)
where T: VarValue,

P Optional command parameter for the button to use when notifying cmd.

If T is Option<CommandParam> the param can be dynamically unset, otherwise the value is the param.

source

pub fn cmd_child_fn(&self, cmd_child: impl IntoVar<WidgetFn<Command>>)

P Sets the widget function used to produce the button child when cmd is set and child is not.

source

pub fn cmd_tooltip_fn( &self, cmd_tooltip: impl IntoVar<WidgetFn<CmdTooltipArgs>>, )

P Sets the widget function used to produce the button tooltip when cmd is set and tooltip is not.

Methods from Deref<Target = FocusableMix<StyleMix<Container>>>§

source

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

P Makes the widget focusable when set to true.

source

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.

source

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.

source

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.

source

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.

source

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.

source

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.

source

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.

source

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.

source

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§

source§

impl Deref for Toggle

source§

type Target = Button

The resulting type after dereferencing.
source§

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

Dereferences the value.
source§

impl DerefMut for Toggle

source§

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

Mutably dereferences the value.

Auto Trait Implementations§

§

impl !Freeze for Toggle

§

impl !RefUnwindSafe for Toggle

§

impl Send for Toggle

§

impl !Sync for Toggle

§

impl Unpin for Toggle

§

impl !UnwindSafe for Toggle

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

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
source§

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

source§

fn into(self) -> U

Calls U::from(self).

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

source§

impl<T> IntoEither for T

source§

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
source§

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
§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> Same for T

source§

type Output = T

Should always be Self
source§

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

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,

§

impl<T> MaybeSendSync for T