Struct cursive::views::ListView

pub struct ListView { /* fields omitted */ }

Displays a list of elements.

Implementations

impl ListView

pub fn new() -> ListView

Creates a new, empty ListView.

pub fn len(&self) -> usize

Returns the number of children, including delimiters.

pub fn is_empty(&self) -> bool

Returns true if this view contains no children.

Returns false if at least a delimiter or a view is present.

pub fn children(&self) -> &[ListChild]

Returns a reference to the children

pub fn get_row(&self, id: usize) -> &ListChild

Returns a reference to the child at the given position.

pub fn row_mut(&mut self, id: usize) -> &mut ListChild

Gives mutable access to the child at the given position.

Panics

Panics if id >= self.len().

pub fn add_child<V>(&mut self, label: &str, view: V) where
    V: 'static + IntoBoxedView, 

Adds a view to the end of the list.

pub fn clear(&mut self)

Removes all children from this view.

pub fn child<V>(self, label: &str, view: V) -> ListView where
    V: 'static + IntoBoxedView, 

Adds a view to the end of the list.

Chainable variant.

pub fn add_delimiter(&mut self)

Adds a delimiter to the end of the list.

pub fn delimiter(self) -> ListView

Adds a delimiter to the end of the list.

Chainable variant.

pub fn remove_child(&mut self, index: usize) -> ListChild

Removes a child from the view.

Panics

If index >= self.len().

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

Sets a callback to be used when an item is selected.

pub fn on_select<F>(self, cb: F) -> ListView where
    F: Fn(&mut Cursive, &String) + 'static, 

Sets a callback to be used when an item is selected.

Chainable variant.

pub fn focus(&self) -> usize

Returns the index of the currently focused item.

Panics if the list is empty.

Trait Implementations

impl Default for ListView

pub fn default() -> ListView

Returns the "default value" for a type.

impl View for ListView

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

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

pub fn required_size(&mut self, req: XY<usize>) -> XY<usize>

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

pub fn layout(&mut self, size: XY<usize>)

Called once the size for this view has been decided.

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

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

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

This view is offered focus. Will it take it?

pub fn call_on_any(
    &mut self,
    selector: &Selector<'_>,
    callback: &'a mut (dyn FnMut(&mut (dyn View + 'static)) + 'a)
)

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

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

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

pub fn important_area(&self, size: XY<usize>) -> Rect

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

pub fn needs_relayout(&self) -> bool

Should return true if the view content changed since the last call to layout().

pub fn type_name(&self) -> &'static str

Returns the type of this view.