Struct RichEditHandle 

pub struct RichEditHandle { /* private fields */ }

A cheap, cloneable handle to a shared RichEditCore, so a toolbar can drive the same editor the widget renders. All mutating calls request a redraw.

Implementations

impl RichEditHandle

pub fn exec(&self, cmd: &RichCommand)

Apply a formatting command through the shared core.

pub fn common_style_of_selection(&self) -> CommonStyle

Summary of the styles under the current selection (drives toolbar state).

pub fn select_all(&self)

Select the whole document, then request a redraw.

pub fn set_caret(&self, pos: DocPos)

Move the caret to pos (clamped onto a valid position), collapsing any selection, and request a redraw.

pub fn set_selection(&self, range: DocRange)

Set the selection to range — range.start becomes the fixed anchor and range.end the moving caret, each clamped onto a valid position — and request a redraw.

pub fn selection(&self) -> DocRange

The current selection (anchor → caret; collapsed when they coincide).

pub fn plain_text(&self) -> String

The document’s plain text (blocks joined by \n).

pub fn load(&self, doc: RichDoc)

Replace the editor’s document with doc, resetting the caret to the start and discarding the undo/redo history (the loaded document is the new baseline). Requests a redraw.

pub fn undo(&self)

Undo one step through the shared core, requesting a redraw on change.

pub fn redo(&self)

Redo one step through the shared core, requesting a redraw on change.

pub fn can_undo(&self) -> bool

Whether an undo step is available.

pub fn can_redo(&self) -> bool

Whether a redo step is available.

pub fn begin_preview(&self)

Begin a live-preview session — see RichEditCore::begin_preview. Call when a colour dialog opens, before any preview exec.

pub fn commit_preview(&self)

Commit the live preview (dialog’s Select) — see RichEditCore::commit_preview.

pub fn cancel_preview(&self)

Cancel the live preview (dialog’s Cancel / Escape / close) — restores the state captured when the preview began. See RichEditCore::cancel_preview.

pub fn is_previewing(&self) -> bool

Whether a live preview is currently active. Exposed so a host can assert (in tests) that every dialog-dismissal route unwinds the session.

pub fn is_preview_dirty(&self) -> bool

Whether the active preview session has changed the document. The colour dialog’s click-away handler reads this to decide whether to commit the live change (one undo step) or cancel it silently. See RichEditCore::is_preview_dirty.

Trait Implementations

impl Clone for RichEditHandle

fn clone(&self) -> RichEditHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.