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_push<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: Widget> HasBool for Button<W>where
    W: HasBool,

fn get_bool(&self) -> bool

Get the widget’s state

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

Set the widget’s state

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

fn get_str(&self) -> &str

Get text by reference

fn get_string(&self) -> String

Get text as a String

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

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

Set text from a &str

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

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: Widget> SetAccel for Button<W>where
    W: SetAccel,

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

Set accel string

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

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<'_>,
    index: usize,
    event: Event
) -> Response

Handle an event sent to child index but left unhandled

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

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