Struct kas_widgets::Button

pub struct Button<W: Widget> {
    pub inner: W,
    /* private fields */
}

A push-button with a generic label

Default alignment of content is centered.

Fields

inner: W

Implementations

impl<W: Widget> Button<W>

pub fn new(inner: W) -> Self

Construct a button with given inner widget

pub fn on_press<F>(self, f: F) -> Button<W>where F: Fn(&mut EventMgr<'_>) + 'static,

Set event handler f

This closure is called when the button is activated.

impl<W: Widget> Button<W>

pub fn new_on<F>(inner: W, f: F) -> Selfwhere F: Fn(&mut EventMgr<'_>) + 'static,

Construct a button with a given inner widget and event handler f

This closure is called when the button is activated.

pub fn new_msg<M: Clone + Debug + 'static>(inner: W, msg: M) -> Self

Construct a button with a given inner and payload msg

When the button is activated, a clone of msg is sent to the parent widget. The parent (or an ancestor) should handle this using Widget::handle_message.

pub fn with_keys(self, keys: &[VirtualKeyCode]) -> Self

Add accelerator keys (chain style)

pub fn set_color(&mut self, color: Option<Rgb>)

Set button color

pub fn with_color(self, color: Rgb) -> Self

Set button color (chain style)

Trait Implementations

impl<W: Widget> AutoLayout for Button<W>

fn size_rules(&mut self, size_mgr: SizeMgr<'_>, axis: AxisInfo) -> SizeRules

Get size rules for the given axis

fn set_rect(&mut self, mgr: &mut ConfigMgr<'_>, rect: Rect)

Set size and position

fn find_id(&mut self, coord: Coord) -> Option<WidgetId>

Translate a coordinate to a WidgetId

fn draw(&mut self, draw: DrawMgr<'_>)

Draw a widget and its children

impl<W: Clone + Widget> Clone for Button<W>

fn clone(&self) -> Button<W>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<W: Widget> Debug for Button<W>

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

Formats the value using the given formatter.

impl<W> HasBool for Button<W>where W: HasBool + Widget,

fn get_bool(&self) -> bool

Get the widget’s state

fn set_bool(&mut self, state: bool) -> Action

Set the widget’s state

impl<W> HasStr for Button<W>where W: HasStr + Widget,

fn get_str(&self) -> &str

Get text by reference

fn get_string(&self) -> String

Get text as a String

impl<W> HasString for Button<W>where W: HasString + Widget,

fn set_str(&mut self, text: &str) -> Action

Set text from a &str

fn set_string(&mut self, text: String) -> Action

Set text from a string

impl<W: Widget> Layout for Button<W>

fn size_rules(&mut self, size_mgr: SizeMgr<'_>, axis: AxisInfo) -> SizeRules

Get size rules for the given axis

fn set_rect(&mut self, mgr: &mut ConfigMgr<'_>, rect: Rect)

Set size and position

fn find_id(&mut self, coord: Coord) -> Option<WidgetId>

Translate a coordinate to a WidgetId

fn draw(&mut self, draw: DrawMgr<'_>)

Draw a widget and its children

impl<W> SetAccel for Button<W>where W: SetAccel + Widget,

fn set_accel_string(&mut self, accel: AccelString) -> Action

Set accel string

fn set_accel<T>(&mut self, accel: T) -> Actionwhere T: Into<AccelString>, Self: Sized,

Set text

impl<W: Widget> Widget for Button<W>

fn configure(&mut self, mgr: &mut ConfigMgr<'_>)

Configure widget

fn handle_event(&mut self, mgr: &mut EventMgr<'_>, event: Event) -> Response

Handle an Event sent to this widget

fn pre_configure(&mut self, _: &mut ConfigMgr<'_>, id: WidgetId)

Pre-configuration

fn navigable(&self) -> bool

Is this widget navigable via Tab key?

fn nav_next( &mut self, _: &mut ConfigMgr<'_>, reverse: bool, from: Option<usize> ) -> Option<usize>

Navigation in spatial order

fn translation(&self) -> Offset

Get translation of children relative to this widget

fn steal_event( &mut self, mgr: &mut EventMgr<'_>, id: &WidgetId, event: &Event ) -> Response

Potentially steal an event before it reaches a child

fn handle_unused(&mut self, mgr: &mut EventMgr<'_>, event: Event) -> Response

Handle an event sent to child index but left unhandled

fn handle_message(&mut self, mgr: &mut EventMgr<'_>)

Handler for messages from children/descendants

fn handle_scroll(&mut self, mgr: &mut EventMgr<'_>, scroll: Scroll)

Handler for scrolling

impl<W: Widget> WidgetChildren for Button<W>

fn num_children(&self) -> usize

Get the number of child widgets

fn get_child(&self, _index: usize) -> Option<&dyn Widget>

Get a reference to a child widget by index, or None if the index is out of bounds.

fn get_child_mut(&mut self, _index: usize) -> Option<&mut dyn Widget>

Mutable variant of get

fn find_child_index(&self, id: &WidgetId) -> Option<usize>

Find the child which is an ancestor of this id, if any

fn make_child_id(&mut self, index: usize) -> WidgetId

Make an identifier for a child

impl<W: Widget> WidgetCore for Button<W>

fn id_ref(&self) -> &WidgetId

Get the widget’s identifier

fn rect(&self) -> Rect

Get the widget’s region, relative to its parent.

fn widget_name(&self) -> &'static str

Get the name of the widget struct

fn as_widget(&self) -> &dyn Widget

Erase type

fn as_widget_mut(&mut self) -> &mut dyn Widget

Erase type