Struct Focus 

pub struct Focus {
    pub model: String,
    pub row: Option<String>,
    pub caret: usize,
    pub anchor: usize,
    pub preedit: Option<(usize, usize)>,
}

Which input has keyboard focus, and where its caret and selection are.

The selection is the range between anchor (where it started) and caret (where it has been dragged/extended to); anchor == caret means no selection, just a caret. Either may be the smaller, dragging leftwards puts the caret before the anchor, so consumers normalize with Focus::range.

Fields

model: String

row: Option<String>

The r-key of the r-for row holding this input, when it is in one.

model is the r-model expression as written, so every row of a list shares it and cannot identify which row the caret is in. The row’s key is the other half. It also makes the caret follow its row when the list reorders: the identity is the row, not the position, so nothing has to be remapped afterwards.

caret: usize

anchor: usize

preedit: Option<(usize, usize)>

The byte range of an in-progress IME composition, if one is running. The composed text is already in the bound value; this only marks which part of it is provisional, so the painter can underline it.

Implementations

impl Focus

pub fn at(model: impl Into<String>, caret: usize) -> Self

A plain caret with nothing selected, in an input that is not in a list.

pub fn at_row( model: impl Into<String>, row: Option<String>, caret: usize, ) -> Self

The same, in a known r-for row.

pub fn is(&self, model: &str, row: Option<&str>) -> bool

Whether this focus is the input bound to model in row row. Both halves matter: a list’s rows all share one model.

pub fn range(&self) -> (usize, usize)

The selected range, low to high.

pub fn is_collapsed(&self) -> bool

Trait Implementations

impl Clone for Focus

fn clone(&self) -> Focus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Focus

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

Formats the value using the given formatter.

impl PartialEq for Focus

fn eq(&self, other: &Focus) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Focus