Struct cursive::views::Button

pub struct Button { /* private fields */ }

Simple text label with a callback when is pressed.

A button shows its content in a single line and has a fixed size.

Examples

let quit_button = Button::new("Quit", |s| s.quit());

Implementations

impl Button

pub fn new<F, S>(label: S, cb: F) -> Selfwhere
    F: 'static + Fn(&mut Cursive),
    S: Into<String>,

Creates a new button with the given content and callback.

pub fn new_raw<F, S: Into<String>>(label: S, cb: F) -> Selfwhere
    F: 'static + Fn(&mut Cursive),

Creates a new button without angle brackets.

pub fn set_callback<F>(&mut self, cb: F)where
    F: Fn(&mut Cursive) + 'static,

Sets the function to be called when the button is pressed.

Replaces the previous callback.

pub fn disable(&mut self)

Disables this view.

A disabled view cannot be selected.

pub fn disabled(self) -> Self

Disables this view.

Chainable variant.

pub fn enable(&mut self)

Re-enables this view.

pub fn set_enabled(&mut self, enabled: bool)

Enable or disable this view.

pub fn is_enabled(&self) -> bool

Returns true if this view is enabled.

pub fn label(&self) -> &str

Returns the label for this button.

Includes brackets.

Examples

let button = Button::new("Quit", |s| s.quit());
assert_eq!(button.label(), "<Quit>");

pub fn set_label<S>(&mut self, label: S)where
    S: Into<String>,

Sets the label to the given value.

This will include brackets.

pub fn set_label_raw<S>(&mut self, label: S)where
    S: Into<String>,

Sets the label exactly to the given value.

This will not include brackets.

Trait Implementations

impl View for Button

fn draw(&self, printer: &Printer<'_, '_>)

Draws the view with the given printer (includes bounds) and focus.

fn layout(&mut self, size: Vec2)

Called once the size for this view has been decided.

fn required_size(&mut self, _: Vec2) -> Vec2

Returns the minimum size the view requires with the given restrictions.

fn on_event(&mut self, event: Event) -> EventResult

Called when an event is received (key press, mouse event, …).

fn take_focus(&mut self, _: Direction) -> bool

This view is offered focus. Will it take it?

fn important_area(&self, view_size: Vec2) -> Rect

What part of the view is important and should be visible?

fn needs_relayout(&self) -> bool

Returns true if the view content changed since last layout phase.

fn call_on_any<'a>(&mut self, _: &Selector<'_>, _: AnyCb<'a>)

Runs a closure on the view identified by the given selector.

fn focus_view(&mut self, : &Selector<'_>) -> Result<(), ()>

Moves the focus to the view identified by the given selector.