Struct TextSelectOp 

pub struct TextSelectOp { /* private fields */ }

Represents a text caret/selection operation that can be send to an editable text using SELECT_CMD.

The provided operations work in rich texts by default, unless they are named with prefix local_. In rich text contexts the operation may generate other SELECT_CMD requests as it propagates to all involved component texts. The local_ operations are for use by other operations only, direct use inside rich text requires updating the rich text state to match.

Implementations

impl TextSelectOp

pub fn next() -> TextSelectOp

Clear selection and move the caret to the next insert index.

This is the Right key operation.

pub fn select_next() -> TextSelectOp

Extend or shrink selection by moving the caret to the next insert index.

This is the SHIFT+Right key operation.

pub fn prev() -> TextSelectOp

Clear selection and move the caret to the previous insert index.

This is the Left key operation.

pub fn select_prev() -> TextSelectOp

Extend or shrink selection by moving the caret to the previous insert index.

This is the SHIFT+Left key operation.

pub fn next_word() -> TextSelectOp

Clear selection and move the caret to the next word insert index.

This is the CTRL+Right shortcut operation.

pub fn select_next_word() -> TextSelectOp

Extend or shrink selection by moving the caret to the next word insert index.

This is the CTRL+SHIFT+Right shortcut operation.

pub fn prev_word() -> TextSelectOp

Clear selection and move the caret to the previous word insert index.

This is the CTRL+Left shortcut operation.

pub fn select_prev_word() -> TextSelectOp

Extend or shrink selection by moving the caret to the previous word insert index.

This is the CTRL+SHIFT+Left shortcut operation.

pub fn line_up() -> TextSelectOp

Clear selection and move the caret to the nearest insert index on the previous line.

This is the Up key operation.

pub fn select_line_up() -> TextSelectOp

Extend or shrink selection by moving the caret to the nearest insert index on the previous line.

This is the SHIFT+Up key operation.

pub fn line_down() -> TextSelectOp

Clear selection and move the caret to the nearest insert index on the next line.

This is the Down key operation.

pub fn select_line_down() -> TextSelectOp

Extend or shrink selection by moving the caret to the nearest insert index on the next line.

This is the SHIFT+Down key operation.

pub fn page_up() -> TextSelectOp

Clear selection and move the caret one viewport up.

This is the PageUp key operation.

pub fn select_page_up() -> TextSelectOp

Extend or shrink selection by moving the caret one viewport up.

This is the SHIFT+PageUp key operation.

pub fn page_down() -> TextSelectOp

Clear selection and move the caret one viewport down.

This is the PageDown key operation.

pub fn select_page_down() -> TextSelectOp

Extend or shrink selection by moving the caret one viewport down.

This is the SHIFT+PageDown key operation.

pub fn line_start() -> TextSelectOp

Clear selection and move the caret to the start of the line.

This is the Home key operation.

pub fn select_line_start() -> TextSelectOp

Extend or shrink selection by moving the caret to the start of the line.

This is the SHIFT+Home key operation.

pub fn line_end() -> TextSelectOp

Clear selection and move the caret to the end of the line (before the line-break if any).

This is the End key operation.

pub fn select_line_end() -> TextSelectOp

Extend or shrink selection by moving the caret to the end of the line (before the line-break if any).

This is the SHIFT+End key operation.

pub fn text_start() -> TextSelectOp

Clear selection and move the caret to the text start.

This is the CTRL+Home shortcut operation.

pub fn select_text_start() -> TextSelectOp

Extend or shrink selection by moving the caret to the text start.

This is the CTRL+SHIFT+Home shortcut operation.

pub fn text_end() -> TextSelectOp

Clear selection and move the caret to the text end.

This is the CTRL+End shortcut operation.

pub fn select_text_end() -> TextSelectOp

Extend or shrink selection by moving the caret to the text end.

This is the CTRL+SHIFT+End shortcut operation.

pub fn nearest_to(window_point: Point2D<Dip, Dip>) -> TextSelectOp

Clear selection and move the caret to the insert point nearest to the window_point.

This is the mouse primary button down operation.

pub fn select_nearest_to(window_point: Point2D<Dip, Dip>) -> TextSelectOp

Extend or shrink selection by moving the caret to the insert point nearest to the window_point.

This is the mouse primary button down when holding SHIFT operation.

pub fn select_word_nearest_to( replace_selection: bool, window_point: Point2D<Dip, Dip>, ) -> TextSelectOp

Replace or extend selection with the word nearest to the window_point

This is the mouse primary button double click.

pub fn select_line_nearest_to( replace_selection: bool, window_point: Point2D<Dip, Dip>, ) -> TextSelectOp

Replace or extend selection with the line nearest to the window_point

This is the mouse primary button triple click.

pub fn select_index_nearest_to( window_point: Point2D<Dip, Dip>, move_selection_index: bool, ) -> TextSelectOp

Extend or shrink selection by moving the caret index or caret selection index to the insert point nearest to window_point.

This is the touch selection caret drag operation.

pub fn select_all() -> TextSelectOp

Select the full text.

pub fn clear_selection() -> TextSelectOp

Clear selection and keep the caret at the same position.

This is the Esc shortcut operation.

impl TextSelectOp

Operations that ignore the rich text context, for internal use only.

pub fn local_next() -> TextSelectOp

Like next but stays within the same text widget, ignores rich text context.

pub fn local_select_next() -> TextSelectOp

Like select_next but stays within the same text widget, ignores rich text context.

pub fn local_prev() -> TextSelectOp

Like prev but stays within the same text widget, ignores rich text context.

pub fn local_select_prev() -> TextSelectOp

Like select_prev but stays within the same text widget, ignores rich text context.

pub fn local_next_word() -> TextSelectOp

Like next_word but stays within the same text widget, ignores rich text context.

pub fn local_select_next_word() -> TextSelectOp

Like select_next_word but stays within the same text widget, ignores rich text context.

pub fn local_prev_word() -> TextSelectOp

Like prev_word but stays within the same text widget, ignores rich text context.

pub fn local_select_prev_word() -> TextSelectOp

Like select_prev_word but stays within the same text widget, ignores rich text context.

pub fn local_line_start() -> TextSelectOp

Like line_start but stays within the same text widget, ignores rich text context.

pub fn local_select_line_start() -> TextSelectOp

Like select_line_start but stays within the same text widget, ignores rich text context.

pub fn local_line_end() -> TextSelectOp

Like line_end but stays within the same text widget, ignores rich text context.

pub fn local_select_line_end() -> TextSelectOp

Like select_line_end but stays within the same text widget, ignores rich text context.

pub fn local_text_start() -> TextSelectOp

Like text_start but stays within the same text widget, ignores rich text context.

pub fn local_select_text_start() -> TextSelectOp

Like select_text_start but stays within the same text widget, ignores rich text context.

pub fn local_text_end() -> TextSelectOp

Like text_end but stays within the same text widget, ignores rich text context.

pub fn local_select_text_end() -> TextSelectOp

Like select_text_end but stays within the same text widget, ignores rich text context.

pub fn local_select_all() -> TextSelectOp

Like select_all but stays within the same text widget, ignores rich text context.

pub fn local_clear_selection() -> TextSelectOp

Like clear_selection but stays within the same text widget, ignores rich text context.

pub fn local_line_up() -> TextSelectOp

Like line_up but stays within the same text widget, ignores rich text context.

pub fn local_select_line_up() -> TextSelectOp

Like select_line_up but stays within the same text widget, ignores rich text context.

pub fn local_line_down() -> TextSelectOp

Like line_down but stays within the same text widget, ignores rich text context.

pub fn local_select_line_down() -> TextSelectOp

Like select_line_down but stays within the same text widget, ignores rich text context.

pub fn local_page_up() -> TextSelectOp

Like page_up but stays within the same text widget, ignores rich text context.

pub fn local_select_page_up() -> TextSelectOp

Like select_page_up but stays within the same text widget, ignores rich text context.

pub fn local_page_down() -> TextSelectOp

Like page_down but stays within the same text widget, ignores rich text context.

pub fn local_select_page_down() -> TextSelectOp

Like select_page_down but stays within the same text widget, ignores rich text context.

pub fn local_nearest_to(window_point: Point2D<Dip, Dip>) -> TextSelectOp

Like nearest_to but stays within the same text widget, ignores rich text context.

pub fn local_select_nearest_to(window_point: Point2D<Dip, Dip>) -> TextSelectOp

Like select_nearest_to but stays within the same text widget, ignores rich text context.

pub fn local_select_index_nearest_to( window_point: Point2D<Dip, Dip>, move_selection_index: bool, ) -> TextSelectOp

Like select_index_nearest_to but stays within the same text widget, ignores rich text context.

pub fn local_select_word_nearest_to( replace_selection: bool, window_point: Point2D<Dip, Dip>, ) -> TextSelectOp

Like select_word_nearest_to but stays within the same text widget, ignores rich text context.

pub fn local_select_line_nearest_to( replace_selection: bool, window_point: Point2D<Dip, Dip>, ) -> TextSelectOp

Like select_line_nearest_to but stays within the same text widget, ignores rich text context.

impl TextSelectOp

pub fn new(op: impl FnMut() + Send + 'static) -> TextSelectOp

New text select operation.

The editable text widget that handles SELECT_CMD will call op during event handling in the node::layout_text context. You can position the caret using TEXT.resolve_caret and TEXT.resolve_rich_caret, the text widget will detect changes to it and react accordingly (updating caret position and animation), the caret index is also snapped to the nearest grapheme start.

pub fn new_rich<D0, D1, D2>( rich_caret_index: impl FnOnce(&RichText) -> (WidgetId, D0) + Send + 'static, local_caret_index: impl FnOnce(D0) -> (CaretIndex, D1) + Send + 'static, rich_selection_index: impl FnOnce(&RichText, D1) -> Option<(WidgetId, D2)> + Send + 'static, local_selection_index: impl FnOnce(D2) -> Option<CaretIndex> + Send + 'static, ) -> TextSelectOp

where D0: Default + Send + 'static, D1: Send + 'static, D2: Default + Send + 'static,

New text selection operation with helpers for implementing rich selection.

The input closures are:

• rich_caret_index - Called if the op executes inside a rich text, must return the leaf widget that will contain the rich text caret.
• local_caret_index - Called in the caret widget context, must return the local caret index.
• rich_selection_index - Called if the op executes inside a rich text, must return the leaf widget that will contain the rich text selection end.
• local_selection_index - Called in selection end widget context, must return the local selection end index.

Data can be passed between each stage with types D0 from rich_caret_index to local_caret_index, D1 from local_caret_index to rich_selection_index and D2 from rich_selection_index to local_selection_index.

If the op is not called inside a rich text only local_caret_index and local_selection_index are called with the default data values.

The rich selection is updated if needed. If the local caret or selection index of an widget is set to 0(start) it is automatically corrected to the end of the previous rich leaf.

Trait Implementations

impl Clone for TextSelectOp

fn clone(&self) -> TextSelectOp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextSelectOp

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

Formats the value using the given formatter.