Struct TextListState 

pub struct TextListState {
    pub items: Vec<String>,
    pub focused_item: Option<usize>,
    pub cursor: usize,
    pub new_item_text: String,
    pub label: String,
    pub focus: FocusState,
    pub is_integer: bool,
    pub pending_active: bool,
}

State for a text list control

Fields

items: Vec<String>

List of items

focused_item: Option<usize>

Currently focused item index (None = add new item field)

cursor: usize

Cursor position within the focused item

new_item_text: String

Text in the “add new” field

label: String

Label displayed above the list

focus: FocusState

Focus state

is_integer: bool

Whether items should be treated as integers (for IntegerArray settings)

pending_active: bool

When focused on the trailing add-new slot (focused_item is None), this is true once the user explicitly enters input mode (Enter on the slot, or starts typing). Until then, the row stays rendered as [+] Add new instead of jumping to an empty [ ] [+] input the moment focus arrives — which was indistinguishable from a committed row and made the [+] row look like it had “disappeared”. Reset on commit / Esc / when focus leaves the trailing slot.

Implementations

impl TextListState

pub fn handle_mouse( &mut self, event: MouseEvent, layout: &TextListLayout, ) -> Option<TextListEvent>

Handle a mouse event for this text list

Arguments

• event - The mouse event to handle
• layout - The control’s rendered layout for hit testing

Returns

• Some(TextListEvent) if the event was consumed
• None if the event was not relevant

pub fn handle_key(&mut self, key: KeyEvent) -> Option<TextListEvent>

Handle a keyboard event for this text list

Returns

• Some(TextListEvent) if the event was consumed
• None if the event was not relevant

impl TextListState

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

Create a new text list state

pub fn with_items(self, items: Vec<String>) -> Self

Set the initial items

pub fn with_integer_mode(self) -> Self

Mark this list as containing integer values

pub fn with_focus(self, focus: FocusState) -> Self

Set the focus state

pub fn is_enabled(&self) -> bool

Check if the control is enabled

pub fn add_item(&mut self)

Add a new item from the new_item_text field

pub fn activate_pending(&mut self)

Mark the trailing add-new slot as “in input mode” — i.e. the user has explicitly chosen to start typing a new item. Called from the dialog’s start_editing flow (Enter on the [+] row) so the visible state machine flips to the bracketed input box.

pub fn cancel_pending(&mut self)

Discard whatever is in the add-new slot and collapse back to [+] Add new. Used for Esc inside the slot.

pub fn insert_str(&mut self, s: &str)

Insert a string at the cursor position

pub fn remove_item(&mut self, index: usize)

Remove an item by index

pub fn focus_item(&mut self, index: usize)

Focus on an item for editing

pub fn focus_new_item(&mut self)

Focus on the new item field

pub fn insert(&mut self, c: char)

Insert a character in the focused field

pub fn backspace(&mut self)

Backspace in the focused field

pub fn move_left(&mut self)

Move cursor left

pub fn move_right(&mut self)

Move cursor right

pub fn move_home(&mut self)

Move cursor to beginning of current field

pub fn move_end(&mut self)

Move cursor to end of current field

pub fn delete(&mut self)

Delete character at cursor (forward delete)

pub fn focus_prev(&mut self)

Move focus to previous item

pub fn focus_next(&mut self)

Move focus to next item

Trait Implementations

impl Clone for TextListState

fn clone(&self) -> TextListState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextListState

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

Formats the value using the given formatter.