Struct TextEditState 

pub struct TextEditState {
    pub text: String,
    pub cursor_pos: usize,
    pub selection_anchor: Option<usize>,
    pub scroll_offset: f32,
    pub scroll_offset_y: f32,
    pub cursor_blink_timer: f64,
    pub last_click_time: f64,
    pub last_click_element: u32,
    pub preferred_col: Option<usize>,
    pub no_styles_movement: bool,
    pub undo_stack: Vec<UndoEntry>,
    pub redo_stack: Vec<UndoEntry>,
}

Persistent text editing state per text input element. Keyed by element u32 ID in PlyContext::text_edit_states.

Fields

text: String

The current text content.

cursor_pos: usize

Character index of the cursor (0 = before first char, text.chars().count() = after last).

selection_anchor: Option<usize>

When Some, defines the anchor of a selection range (anchor..cursor_pos or cursor_pos..anchor).

scroll_offset: f32

Horizontal scroll offset (pixels) when text overflows the bounding box.

scroll_offset_y: f32

Vertical scroll offset (pixels) for multiline text inputs.

cursor_blink_timer: f64

Timer for cursor blink animation (seconds).

last_click_time: f64

Timestamp of last click (for double-click detection).

last_click_element: u32

Element ID of last click (for double-click detection).

preferred_col: Option<usize>

Saved visual column for vertical (up/down) navigation. When set, up/down arrows try to return to this column.

no_styles_movement: bool

When true, cursor movement skips structural style positions (} and empty content markers). Set from TextInputConfig::no_styles_movement.

undo_stack: Vec<UndoEntry>

Undo stack: previous states (newest at end).

redo_stack: Vec<UndoEntry>

Redo stack: states undone (newest at end).

Implementations

impl TextEditState

pub fn selection_range(&self) -> Option<(usize, usize)>

Returns the ordered selection range (start, end) if a selection is active.

pub fn selected_text(&self) -> &str

Returns the selected text, or empty string if no selection.

pub fn delete_selection(&mut self) -> bool

Delete the current selection and place cursor at the start. Returns true if a selection was deleted.

pub fn insert_text(&mut self, s: &str, max_length: Option<usize>)

Insert text at the current cursor position, replacing any selection. Respects max_length if provided.

pub fn move_left(&mut self, shift: bool)

Move cursor left by one character.

pub fn move_right(&mut self, shift: bool)

Move cursor right by one character.

pub fn move_word_left(&mut self, shift: bool)

Move cursor to the start of the previous word.

pub fn move_word_right(&mut self, shift: bool)

Move cursor to the end of the next word.

pub fn move_home(&mut self, shift: bool)

Move cursor to start of line.

pub fn move_end(&mut self, shift: bool)

Move cursor to end of line.

pub fn select_all(&mut self)

Select all text.

pub fn backspace(&mut self)

Delete character before cursor (Backspace).

pub fn delete_forward(&mut self)

Delete character after cursor (Delete key).

pub fn backspace_word(&mut self)

Delete the word before the cursor (Ctrl+Backspace).

pub fn delete_word_forward(&mut self)

Delete the word after the cursor (Ctrl+Delete).

pub fn click_to_cursor( &mut self, click_x: f32, char_x_positions: &[f32], shift: bool, )

Set cursor position from a click at pixel x within the element. char_x_positions should be a sorted list of x-positions for each character boundary (index 0 = left edge of first char, index n = right edge of last char).

pub fn select_word_at(&mut self, char_pos: usize)

Select the word at the given character position (for double-click).

pub fn reset_blink(&mut self)

Reset blink timer so cursor is immediately visible.

pub fn cursor_visible(&self) -> bool

Returns whether the cursor should be visible based on blink timer.

pub fn ensure_cursor_visible(&mut self, cursor_x: f32, visible_width: f32)

Update scroll offset to ensure cursor is visible within visible_width. cursor_x is the pixel x-position of the cursor relative to text start.

pub fn ensure_cursor_visible_vertical( &mut self, cursor_line: usize, line_height: f32, visible_height: f32, )

Update vertical scroll offset to keep cursor visible in multiline mode. cursor_line is the 0-based line index the cursor is on. line_height is pixel height per line. visible_height is the element height.

pub fn push_undo(&mut self, kind: UndoActionKind)

Push the current state onto the undo stack before an edit. kind controls grouping: consecutive edits of the same kind are merged (only InsertChar, Backspace, and Delete are grouped).

pub fn undo(&mut self) -> bool

Undo the last edit. Returns true if undo was performed.

pub fn redo(&mut self) -> bool

Redo the last undone edit. Returns true if redo was performed.

pub fn move_line_home(&mut self, shift: bool)

Move cursor to the start of the current line (Home in multiline mode).

pub fn move_line_end(&mut self, shift: bool)

Move cursor to the end of the current line (End in multiline mode).

pub fn move_up(&mut self, shift: bool)

Move cursor up one line (multiline only).

pub fn move_down(&mut self, shift: bool)

Move cursor down one line (multiline only).

impl TextEditState

When the text-styling feature is enabled, these methods operate on TextEditState using visual (display) cursor positions. The internal text field contains raw markup, but cursor_pos and selection_anchor always represent visual positions.

pub fn selected_text_styled(&self) -> String

Get the selected text in visual space, returning the visible chars.

pub fn delete_selection_styled(&mut self) -> bool

Delete selection in styled mode. Returns true if a selection was deleted.

pub fn insert_text_styled(&mut self, s: &str, max_length: Option<usize>)

Insert text at visual cursor position in styled mode, with escaping. The input s should already be escaped if needed.

pub fn insert_char_styled(&mut self, ch: char, max_length: Option<usize>)

Insert a single typed character in styled mode (auto-escapes).

pub fn backspace_styled(&mut self)

Backspace in styled mode: delete visual char before cursor.

pub fn delete_forward_styled(&mut self)

Delete forward in styled mode: delete visual char after cursor.

pub fn backspace_word_styled(&mut self)

Backspace word in styled mode.

pub fn delete_word_forward_styled(&mut self)

Delete word forward in styled mode.

pub fn move_left_styled(&mut self, shift: bool)

Move left in styled mode (visual space).

pub fn move_right_styled(&mut self, shift: bool)

Move right in styled mode (visual space).

pub fn move_word_left_styled(&mut self, shift: bool)

Move word left in styled mode.

pub fn move_word_right_styled(&mut self, shift: bool)

Move word right in styled mode.

pub fn move_home_styled(&mut self, shift: bool)

Move to start in styled mode.

pub fn move_end_styled(&mut self, shift: bool)

Move to end in styled mode.

pub fn move_up_styled( &mut self, shift: bool, visual_lines: Option<&[VisualLine]>, )

Move cursor up one visual line in styled mode. If visual_lines is provided (multiline with wrapping), uses them for navigation. Otherwise falls back to simple line-based movement.

pub fn move_down_styled( &mut self, shift: bool, visual_lines: Option<&[VisualLine]>, )

Move cursor down one visual line in styled mode.

pub fn select_all_styled(&mut self)

Select all in styled mode.

pub fn click_to_cursor_styled(&mut self, click_visual_pos: usize, shift: bool)

Click to cursor in styled mode. click_visual_pos is the visual character position determined from click x.

pub fn select_word_at_styled(&mut self, visual_pos: usize)

Select word at visual position in styled mode.

pub fn cursor_pos_raw(&self) -> usize

Convert the visual cursor_pos to a raw position for rendering. Enters empty style tags at the cursor boundary.

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

Convert the visual selection_anchor to a raw position for rendering.

pub fn selection_range_raw(&self) -> Option<(usize, usize)>

Get the selection range in raw positions for rendering.

Trait Implementations

impl Clone for TextEditState

fn clone(&self) -> TextEditState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextEditState

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

Formats the value using the given formatter.

impl Default for TextEditState

fn default() -> Self

Returns the “default value” for a type.