Struct cursive::views::StackView

pub struct StackView { /* fields omitted */ }

Simple stack of views. Only the top-most view is active and can receive input.

Methods

impl StackView

pub fn new() -> Self

Creates a new empty StackView

pub fn len(&self) -> usize

Returns the number of layers in this StackView.

pub fn is_empty(&self) -> bool

Returns true if there is no layer in this StackView.

pub fn fits(&self, position: LayerPosition) -> bool

Returns true if position points to a valid layer.

Returns false if it exceeds the bounds.

pub fn add_fullscreen_layer<T>(&mut self, view: T) where
    T: IntoBoxedView, 

Adds a new full-screen layer on top of the stack.

Fullscreen layers have no shadow.

pub fn add_layer<T>(&mut self, view: T) where
    T: IntoBoxedView, 

Adds new view on top of the stack in the center of the screen.

pub fn layer<T>(self, view: T) -> Self where
    T: IntoBoxedView, 

Adds new view on top of the stack in the center of the screen.

Chainable variant.

pub fn get(&self, pos: LayerPosition) -> Option<&dyn View>

Returns a reference to the layer at the given position.

pub fn get_mut(&mut self, pos: LayerPosition) -> Option<&mut dyn View>

Returns a mutable reference to the layer at the given position.

pub fn find_layer_from_id(&mut self, id: &str) -> Option<LayerPosition>

Looks for the layer containing a view with the given ID.

Returns Some(pos) if self.get(pos) has the given ID, or is a parent of a view with this ID.

Returns None if the given ID is not found.

Note that the returned position may be invalidated if some layers are removed from the view.

Examples

let mut stack = StackView::new();
stack.add_layer(TextView::new("Back"));
stack.add_layer(Dialog::around(TextView::new("Middle").with_id("text")));
stack.add_layer(TextView::new("Front"));

assert_eq!(stack.find_layer_from_id("text"), Some(LayerPosition::FromBack(1)));

pub fn fullscreen_layer<T>(self, view: T) -> Self where
    T: IntoBoxedView, 

Adds a new full-screen layer on top of the stack.

Chainable variant.

pub fn transparent_layer<T>(self, view: T) -> Self where
    T: IntoBoxedView, 

Adds a new transparent layer on top of the stack.

Chainable variant.

pub fn add_layer_at<T>(&mut self, position: Position, view: T) where
    T: IntoBoxedView, 

Adds a view on top of the stack.

pub fn add_transparent_layer<T>(&mut self, view: T) where
    T: IntoBoxedView, 

Adds a transparent view on top of the stack in the center of the screen.

pub fn add_transparent_layer_at<T>(&mut self, position: Position, view: T) where
    T: IntoBoxedView, 

Adds a transparent view on top of the stack.

pub fn layer_at<T>(self, position: Position, view: T) -> Self where
    T: IntoBoxedView, 

Adds a view on top of the stack at the given position.

Chainable variant.

pub fn remove_layer(&mut self, position: LayerPosition) -> Box<dyn View>

Remove a layer from this StackView.

Panics

If the given position is out of bounds.

pub fn pop_layer(&mut self) -> Option<Box<dyn View>>

Remove the top-most layer.

pub fn offset(&self) -> Vec2

Computes the offset of the current top view.

pub fn layer_sizes(&self) -> Vec<Vec2>

Returns the size for each layer in this view.

pub fn move_layer(&mut self, from: LayerPosition, to: LayerPosition)

Moves a layer to a new position in the stack.

This only affects the elevation of a layer (whether it is drawn over or under other views).

Panics

If either from or to is out of bounds.

pub fn move_to_front(&mut self, layer: LayerPosition)

Brings the given view to the front of the stack.

Panics

If layer is out of bounds.

pub fn move_to_back(&mut self, layer: LayerPosition)

Pushes the given view to the back of the stack.

Panics

If layer is out of bounds.

pub fn reposition_layer(&mut self, layer: LayerPosition, position: Position)

Moves a layer to a new position on the screen.

Panics

If layer is out of bounds.

pub fn draw_bg(&self, printer: &Printer)

Background drawing

Drawing functions are split into forground and background to ease inserting layers under the stackview but above its background.

you probably just want to call draw()

pub fn draw_fg(&self, printer: &Printer)

Forground drawing

Drawing functions are split into forground and background to ease inserting layers under the stackview but above its background.

You probably just want to call draw()

Trait Implementations

impl View for StackView

fn draw(&self, printer: &Printer)

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

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

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

fn layout(&mut self, size: Vec2)

Called once the size for this view has been decided.

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

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

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

This view is offered focus. Will it take it?

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

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

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

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

fn needs_relayout(&self) -> bool

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

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

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

impl Default for StackView

fn default() -> Self

Returns the "default value" for a type.