Struct Toggler

pub struct Toggler<'a, Message, Theme = Theme, Renderer = Renderer>
where
    Theme: Catalog,
    Renderer: Renderer,
{ /* private fields */ }

A toggler widget.

Example

use iced::widget::toggler;

struct State {
   is_checked: bool,
}

enum Message {
    TogglerToggled(bool),
}

fn view(state: &State) -> Element<'_, Message> {
    toggler(state.is_checked)
        .label("Toggle me!")
        .on_toggle(Message::TogglerToggled)
        .into()
}

fn update(state: &mut State, message: Message) {
    match message {
        Message::TogglerToggled(is_checked) => {
            state.is_checked = is_checked;
        }
    }
}

Implementations

impl<'a, Message, Theme, Renderer> Toggler<'a, Message, Theme, Renderer>

where Theme: Catalog, Renderer: Renderer,

pub const DEFAULT_SIZE: f32 = 16f32

The default size of a Toggler.

pub fn new(is_toggled: bool) -> Toggler<'a, Message, Theme, Renderer>

Creates a new Toggler.

It expects:

• a boolean describing whether the Toggler is checked or not
• An optional label for the Toggler

pub fn label( self, label: impl IntoFragment<'a>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the label of the Toggler.

pub fn on_toggle( self, on_toggle: impl Fn(bool) -> Message + 'a, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the message that should be produced when a user toggles the Toggler.

If this method is not called, the Toggler will be disabled.

pub fn on_toggle_maybe( self, on_toggle: Option<impl Fn(bool) -> Message + 'a>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the message that should be produced when a user toggles the Toggler, if Some.

If None, the Toggler will be disabled.

pub fn size( self, size: impl Into<Pixels>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the size of the Toggler.

pub fn width( self, width: impl Into<Length>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the width of the Toggler.

pub fn text_size( self, text_size: impl Into<Pixels>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the text size o the Toggler.

pub fn text_line_height( self, line_height: impl Into<LineHeight>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the text text::LineHeight of the Toggler.

pub fn text_alignment( self, alignment: impl Into<Alignment>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the horizontal alignment of the text of the Toggler

pub fn text_shaping( self, shaping: Shaping, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the text::Shaping strategy of the Toggler.

pub fn text_wrapping( self, wrapping: Wrapping, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the text::Wrapping strategy of the Toggler.

pub fn text_ellipsize( self, ellipsize: Ellipsize, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the text::Ellipsize strategy of the Toggler.

pub fn spacing( self, spacing: impl Into<Pixels>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the spacing between the Toggler and the text.

pub fn font( self, font: impl Into<<Renderer as Renderer>::Font>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the Renderer::Font of the text of the Toggler

pub fn style( self, style: impl Fn(&Theme, Status) -> Style + 'a, ) -> Toggler<'a, Message, Theme, Renderer>

where <Theme as Catalog>::Class<'a>: From<Box<dyn Fn(&Theme, Status) -> Style + 'a>>,

Sets the style of the Toggler.

pub fn class( self, class: impl Into<<Theme as Catalog>::Class<'a>>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the style class of the Toggler.

pub fn name( self, name: impl Into<Cow<'a, str>>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the name of the Toggler.

pub fn description_widget<T>( self, description: &T, ) -> Toggler<'a, Message, Theme, Renderer>

where T: Describes,

Sets the description of the Toggler.

pub fn description( self, description: impl Into<Cow<'a, str>>, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the description of the Toggler.

pub fn labeled_by_widget( self, label: &dyn Labels, ) -> Toggler<'a, Message, Theme, Renderer>

Sets the label of the Toggler using another widget.

Trait Implementations

impl<'a, Message, Theme, Renderer> From<Toggler<'a, Message, Theme, Renderer>> for Element<'a, Message, Theme, Renderer>

where Message: 'a, Theme: Catalog + 'a, Renderer: Renderer + 'a,

fn from( toggler: Toggler<'a, Message, Theme, Renderer>, ) -> Element<'a, Message, Theme, Renderer>

Converts to this type from the input type.

impl<Message, Theme, Renderer> Widget<Message, Theme, Renderer> for Toggler<'_, Message, Theme, Renderer>

where Theme: Catalog, Renderer: Renderer,

fn a11y_nodes( &self, layout: Layout<'_>, _state: &Tree, cursor: Cursor, ) -> A11yTree

get the a11y nodes for the widget

fn tag(&self) -> Tag

Returns the Tag of the Widget.

fn state(&self) -> State

Returns the State of the Widget.

fn size(&self) -> Size<Length>

Returns the Size of the Widget in lengths.

fn layout( &mut self, tree: &mut Tree, renderer: &Renderer, limits: &Limits, ) -> Node

Returns the layout::Node of the Widget.

fn update( &mut self, _tree: &mut Tree, event: &Event, layout: Layout<'_>, cursor: Cursor, _renderer: &Renderer, _clipboard: &mut dyn Clipboard, shell: &mut Shell<'_, Message>, _viewport: &Rectangle, )

Processes a runtime Event.

fn mouse_interaction( &self, _tree: &Tree, layout: Layout<'_>, cursor: Cursor, _viewport: &Rectangle, _renderer: &Renderer, ) -> Interaction

Returns the current mouse::Interaction of the Widget.

fn draw( &self, tree: &Tree, renderer: &mut Renderer, theme: &Theme, defaults: &Style, layout: Layout<'_>, cursor: Cursor, viewport: &Rectangle, )

Draws the Widget using the associated Renderer.

fn id(&self) -> Option<Id>

Returns the id of the widget

fn set_id(&mut self, id: Id)

Sets the id of the widget This may be called while diffing the widget tree

fn size_hint(&self) -> Size<Length>

Returns a Size hint for laying out the Widget.

fn children(&self) -> Vec<Tree>

Returns the state Tree of the children of the Widget.

fn diff(&mut self, tree: &mut Tree)

Reconciles the Widget with the provided Tree.

fn operate( &mut self, _tree: &mut Tree, _layout: Layout<'_>, _renderer: &Renderer, _operation: &mut dyn Operation, )

Applies an Operation to the Widget.

fn overlay<'a>( &'a mut self, _tree: &'a mut Tree, _layout: Layout<'a>, _renderer: &Renderer, _viewport: &Rectangle, _translation: Vector, ) -> Option<Element<'a, Message, Theme, Renderer>>

Returns the overlay of the Widget, if there is any.

fn drag_destinations( &self, _state: &Tree, _layout: Layout<'_>, _renderer: &Renderer, _dnd_rectangles: &mut DndDestinationRectangles, )

Adds the drag destination rectangles of the widget. Runs after the layout phase for each widget in the tree.