Struct ListState 

pub struct ListState {
    pub selected: Option<usize>,
    pub offset: usize,
    /* private fields */
}

Mutable state for a List widget tracking selection and scroll offset.

Fields

selected: Option<usize>

Index of the currently selected item, if any.

offset: usize

Scroll offset (first visible item index).

Implementations

impl ListState

pub fn select(&mut self, index: Option<usize>)

Set the selected item index, or None to deselect.

pub fn selected(&self) -> Option<usize>

Return the currently selected item index.

pub fn with_persistence_id(self, id: impl Into<String>) -> Self

Create a new ListState with a persistence ID for state saving.

pub fn persistence_id(&self) -> Option<&str>

Get the persistence ID, if set.

impl ListState

pub fn undo_id(&self) -> UndoWidgetId

Get the undo widget ID.

This can be used to associate undo commands with this state instance.

Trait Implementations

impl Clone for ListState

fn clone(&self) -> ListState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ListState

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

Formats the value using the given formatter.

impl Default for ListState

fn default() -> ListState

Returns the “default value” for a type.

impl ListUndoExt for ListState

fn selected_index(&self) -> Option<usize>

Get the current selection.

fn set_selected_index(&mut self, index: Option<usize>)

Set the selection.

impl Stateful for ListState

type State = ListPersistState

The state type that gets persisted.

fn state_key(&self) -> StateKey

Unique key identifying this widget instance.

fn save_state(&self) -> ListPersistState

Extract current state for persistence.

fn restore_state(&mut self, state: ListPersistState)

Restore state from persistence.

fn state_version() -> u32

State schema version for forward-compatible migrations.

impl UndoSupport for ListState

fn undo_widget_id(&self) -> UndoWidgetId

Get the widget’s unique ID for undo tracking.

fn create_snapshot(&self) -> Box<dyn Any + Send>

Create a snapshot of the current state for undo purposes.

fn restore_snapshot(&mut self, snapshot: &dyn Any) -> bool

Restore state from a snapshot.