Trait cursive::view::View [] [src]

pub trait View: Any {
    fn draw(&self, printer: &Printer);

    fn on_event(&mut self, Event) -> EventResult { ... }
fn required_size(&mut self, constraint: Vec2) -> Vec2 { ... }
fn needs_relayout(&self) -> bool { ... }
fn layout(&mut self, Vec2) { ... }
fn call_on_any<'a>(&mut self, _: &Selector, _: Box<FnMut(&mut Any) + 'a>) { ... }
fn focus_view(&mut self, &Selector) -> Result<(), ()> { ... }
fn take_focus(&mut self, source: Direction) -> bool { ... } }

Main trait defining a view behaviour.

Required Methods

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

Provided Methods

Called when a key was pressed.

Default implementation just ignores it.

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

If the view is flexible (it has multiple size options), it can try to return one that fits the given constraint. It's also fine to ignore it and return a fixed value.

Default implementation always return (1,1).

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

This is mostly an optimisation for views where the layout phase is expensive.

  • Views can ignore it and always return true (default implementation). They will always be assumed to have changed.
  • View Groups can ignore it and always re-layout their children.
    • If they call required_size or layout with stable parameters, the children may cache the result themselves and speed up the process anyway.

Called once the size for this view has been decided,

View groups should propagate the information to their children.

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

See Finder::call_on for a nicer interface, implemented for all views.

If the selector doesn't find a match, the closure will not be run.

Default implementation is a no-op.

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

Returns Ok(()) if the view was found and selected.

Default implementation simply returns Err(()).

This view is offered focus. Will it take it?

source indicates where the focus comes from. When the source is unclear, Front is usually used.

Default implementation always return false.