Struct ScreenState 

pub struct ScreenState { /* private fields */ }

Navigation stack state for multi-screen apps.

Tracks screen names in a push/pop stack while preserving the root screen. Each screen gets isolated focus and hook state when used with crate::Context::screen.

Example

let mut screens = slt::ScreenState::new("main");

slt::run(|ui| {
    let current = screens.current().to_string();
    if current == "main" {
        if ui.button("Settings").clicked { screens.push("settings"); }
    }
    if current == "settings" {
        if ui.button("Back").clicked { screens.pop(); }
    }
});

Implementations

impl ScreenState

pub fn new(initial: impl Into<String>) -> Self

Create a screen stack with an initial root screen.

pub fn current(&self) -> &str

Return the current screen name (top of the stack).

pub fn push(&mut self, name: impl Into<String>)

Push a new screen onto the stack.

pub fn pop(&mut self)

Pop the current screen, preserving the root screen.

pub fn depth(&self) -> usize

Return current stack depth.

pub fn can_pop(&self) -> bool

Return true if popping is allowed.

pub fn contains(&self, name: &str) -> bool

Return true if name is currently present in the navigation stack.

pub fn reset(&mut self)

Reset to only the root screen.

pub fn remove_inactive(&mut self, name: &str) -> bool

Remove retained focus state for a screen that is no longer on the stack.

Returns false when the screen is still active or stacked, because dropping focus for a live screen would make back navigation jumpy.

pub fn retain_inactive(&mut self, keep: impl FnMut(&str) -> bool) -> usize

Retain inactive focus-state entries accepted by keep.

Screens still present in the stack are always kept. Returns the number of focus-state entries removed.

pub fn focus_state_count(&self) -> usize

Number of retained per-screen focus entries.

Diagnostic helper for apps with runtime-generated screen names.

Trait Implementations

impl Clone for ScreenState

fn clone(&self) -> ScreenState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ScreenState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.