Struct ModalStack 

pub struct ModalStack { /* private fields */ }

Stack of Dialogs. The topmost dialog receives keys first; DialogOutcome::Close pops it.

The Send bound on the contained trait objects keeps ModalStack usable inside an async task that may be moved between tokio worker threads.

Implementations

impl ModalStack

pub const fn new() -> Self

Empty stack.

pub fn is_empty(&self) -> bool

True if no dialog is on the stack.

pub fn depth(&self) -> usize

Number of dialogs on the stack.

pub fn top(&self) -> Option<&(dyn Dialog + Send)>

Reference to the topmost dialog, if any.

pub fn push(&mut self, dialog: Box<dyn Dialog + Send>)

Push a dialog onto the stack. It becomes the new top.

pub fn pop(&mut self) -> Option<Box<dyn Dialog + Send>>

Pop the topmost dialog off the stack.

pub fn clear(&mut self)

Clear the entire stack — used on forced-quit / device-disconnect.

pub fn handle_key(&mut self, key: KeyEvent) -> DialogOutcome

Route a key event to the topmost dialog. Empty stack returns DialogOutcome::Consumed (nothing to do).

Automatically handles two stack-management outcomes:

• DialogOutcome::Close pops the top dialog.
• DialogOutcome::Push pushes the returned dialog onto the stack and reports DialogOutcome::Consumed to the caller (the push is an internal transition).

Trait Implementations

impl Default for ModalStack

fn default() -> Self

Returns the “default value” for a type.