Struct TextSelection 

pub struct TextSelection;

Window-level operations for text selection.

Implementations

impl TextSelection

pub fn selected_text(window: &mut Window, cx: &mut App) -> String

Returns the currently selected text in logical document order.

pub fn has_selection(window: &mut Window, cx: &mut App) -> bool

Returns whether the window has a geometry selection or any participant has an active participant-local selection such as select-all.

pub fn clear(window: &mut Window, cx: &mut App)

Clears window selection and every participant’s local selection.

pub fn clear_for_window(window_id: WindowId, cx: &mut App)

Clears selection for a known window identifier.

Prefer Self::clear when a window reference is available. This narrow entry point supports hosts retiring deprecated window wrappers.

pub fn end(window: &mut Window, cx: &mut App)

Ends the current drag while leaving its selection visible.

pub fn observe_touch_selection( window: &Window, cx: &mut App, callback: impl Fn(&mut App) + 'static, ) -> Subscription

Calls callback whenever the touch selection changes: it appears, its handles move, its menu opens or closes, or it goes away. Whoever draws the handles and the menu re-renders from here.

pub fn touch_selection( window: &Window, cx: &App, ) -> Option<TouchSelectionSnapshot>

Returns the selection a long press made, laid out for its handles and edit menu, or None when the selection was made with a pointer.

pub fn register_touch_ui(bounds: Bounds<Pixels>, window: &Window, cx: &mut App)

Records where a touch handle or the edit menu is painted this frame, so that pressing it does not clear the selection it belongs to. Call from paint, every frame the surface is shown.

pub fn close_edit_menu(window: &mut Window, cx: &mut App)

Closes the edit menu and keeps the selection with its handles.

pub fn select_all(window: &mut Window, cx: &mut App)

Selects all of the text the touch selection started in, keeping the handles and the edit menu over the result.

pub fn begin_edge_drag( edge: SelectionEdge, finger: Point<Pixels>, window: &mut Window, cx: &mut App, )

Starts dragging one end of the touch selection from finger. The other end stays; the menu closes until Self::end_edge_drag.

pub fn update_edge_drag( finger: Point<Pixels>, window: &mut Window, cx: &mut App, )

Moves the dragged end to the text under finger.

pub fn end_edge_drag(window: &mut Window, cx: &mut App)

Ends the handle drag and reopens the edit menu over the result.

pub fn activate_scope( scope: TextSelectionScopeId, window: &mut Window, cx: &mut App, )

Activates the opaque selection scope for this window.