Struct TextFieldHandle 

pub struct TextFieldHandle { /* private fields */ }

A live handle on a TextInputField — its text-editing commands, for a caller outside the widget.

Every method is a no-op before the field is built (and after it is destroyed), which is the honest answer rather than a panic: a menu row bound to a field that is no longer on screen should do nothing, not crash.

Implementations

impl TextFieldHandle

pub fn detached() -> Self

A handle not yet attached to any field — for a composing widget that hands one out before building the field it will delegate to. Every method answers “nothing” until TextInputField::share_handle binds it.

pub fn focused_signal(&self) -> Signal<bool>

true while this field holds the keyboard focus. Observable, so a router can follow the caret without polling.

pub fn is_live(&self) -> bool

Is the widget built and still alive?

pub fn text(&self) -> String

The field’s current text.

pub fn has_selection(&self) -> bool

Is any text selected right now?

pub fn allows_copy(&self) -> bool

May this field’s content be copied at all? A password field says no — see TextInputField::allow_copy.

pub fn is_read_only(&self) -> bool

Is the field refusing edits? Cut and Paste are meaningless when it is.

pub fn select_all(&self)

Select the whole field.

pub fn copy(&self, ctx: &EventContext<'_>)

Copy the selection to the clipboard.

pub fn cut(&self, ctx: &EventContext<'_>)

Cut the selection to the clipboard.

pub fn paste(&self, ctx: &EventContext<'_>)

Paste over the selection.

pub fn undo(&self)

Undo this field’s own last edit.

pub fn redo(&self)

Redo this field’s own last undone edit.

pub fn can_undo(&self) -> Signal<bool>

Is there anything to undo? Debounced like the editor’s twin.

pub fn can_redo(&self) -> Signal<bool>

Is there anything to redo?

Trait Implementations

impl Clone for TextFieldHandle

fn clone(&self) -> TextFieldHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextFieldHandle

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

Formats the value using the given formatter.

impl TextSurface for TextFieldHandle

fn paste_plain(&self, ctx: &EventContext<'_>)

A one-line field carries no formatting to strip, so the plain paste is the paste. Answering “nothing” here would make Edit ▸ Paste without formatting silently dead over a rename box.

fn can_undo(&self) -> bool

Is there anything in this surface’s own history to step back through?

fn can_redo(&self) -> bool

Is there anything to step forward into?

fn undo(&self)

fn redo(&self)

fn has_selection(&self) -> bool

Is any text selected right now?

fn is_read_only(&self) -> bool

Does this surface refuse edits? Cut and Paste are meaningless when it does.

fn allows_copy(&self) -> bool

May its contents be copied at all? A password field says no.

fn cut(&self, ctx: &EventContext<'_>)

fn copy(&self, ctx: &EventContext<'_>)

fn paste(&self, ctx: &EventContext<'_>)

fn select_all(&self)

fn history_frozen(&self) -> bool

Is this surface refusing to step through its history at all?