Struct TextCore 

pub struct TextCore<Store> { /* private fields */ }

Core for text editing.

Implementations

impl<Store> TextCore<Store>

where Store: TextStore + Default,

pub fn new( undo: Option<Box<dyn UndoBuffer>>, clip: Option<Box<dyn Clipboard>>, ) -> TextCore<Store>

pub fn set_glyph_ctrl(&mut self, show_ctrl: bool)

Show control characters when iterating glyphs.

pub fn glyph_ctrl(&self) -> bool

Show glyphs for text-wrap.

pub fn set_wrap_ctrl(&mut self, wrap_ctrl: bool)

Show glyphs for text-wrap.

pub fn wrap_ctrl(&self) -> bool

Show control characters when iterating glyphs.

impl<Store> TextCore<Store>

where Store: TextStore + Default,

pub fn set_clipboard(&mut self, clip: Option<Box<dyn Clipboard>>)

Clipboard

pub fn clipboard(&self) -> Option<&dyn Clipboard>

Clipboard

impl<Store> TextCore<Store>

where Store: TextStore + Default,

pub fn set_undo_buffer(&mut self, undo: Option<Box<dyn UndoBuffer>>)

Undo

pub fn set_undo_count(&mut self, n: u32)

Set undo count

pub fn begin_undo_seq(&mut self)

Begin a sequence of changes that should be undone in one go.

pub fn end_undo_seq(&mut self)

End a sequence of changes that should be undone in one go.

pub fn undo_buffer(&self) -> Option<&dyn UndoBuffer>

Undo

pub fn undo_buffer_mut(&mut self) -> Option<&mut dyn UndoBuffer>

Undo

pub fn undo(&mut self) -> bool

Undo last.

pub fn redo(&mut self) -> bool

Redo last.

pub fn recent_replay_log(&mut self) -> Vec<UndoEntry>

Get last replay recording.

pub fn replay_log(&mut self, replay: &[UndoEntry])

Replay a recording of changes.

impl<Store> TextCore<Store>

where Store: TextStore + Default,

pub fn set_styles(&mut self, new_styles: Vec<(Range<usize>, usize)>)

Set all styles.

The ranges are byte-ranges. The usize value is the index of the actual style. Those are set with the widget.

pub fn add_style(&mut self, range: Range<usize>, style: usize)

Add a style for the given byte-range.

The usize value is the index of the actual style. Those are set at the widget.

pub fn remove_style(&mut self, range: Range<usize>, style: usize)

Remove a style for the given byte-range.

Range and style must match to be removed.

pub fn remove_style_fully(&mut self, style: usize)

Remove all ranges for the given style.

pub fn styles_in( &self, range: Range<usize>, buf: &mut Vec<(Range<usize>, usize)>, )

Find all styles that touch the given range.

pub fn styles_in_match( &self, range: Range<usize>, style: usize, buf: &mut Vec<(Range<usize>, usize)>, )

Find all styles that touch the given range.

pub fn styles_at(&self, byte_pos: usize, buf: &mut Vec<(Range<usize>, usize)>)

Finds all styles for the given position.

pub fn styles_at_match( &self, byte_pos: usize, style: usize, ) -> Option<Range<usize>>

Finds all styles for the given position.

pub fn styles(&self) -> Option<impl Iterator<Item = (Range<usize>, usize)>>

List of all styles.

impl<Store> TextCore<Store>

where Store: TextStore + Default,

pub fn set_cursor( &mut self, cursor: TextPosition, extend_selection: bool, ) -> bool

Set the cursor position. The value is capped to the number of text lines and the line-width for the given line.

Returns true, if the cursor actually changed.

pub fn cursor(&self) -> TextPosition

Cursor position as grapheme-idx.

pub fn anchor(&self) -> TextPosition

Selection anchor

pub fn has_selection(&self) -> bool

Any text selection.

pub fn set_selection( &mut self, anchor: TextPosition, cursor: TextPosition, ) -> bool

Select text. Anchor and cursor are capped to a valid value.

pub fn select_all(&mut self) -> bool

Select all text.

pub fn selection(&self) -> TextRange

Returns the selection as TextRange.

impl<Store> TextCore<Store>

where Store: TextStore + Default,

pub fn is_empty(&self) -> bool

Empty.

pub fn byte_at(&self, pos: TextPosition) -> Result<Range<usize>, TextError>

Grapheme position to byte position. This is the (start,end) position of the single grapheme after pos.

pub fn bytes_at_range( &self, range: TextRange, ) -> Result<Range<usize>, TextError>

Grapheme range to byte range.

pub fn byte_pos(&self, byte: usize) -> Result<TextPosition, TextError>

Byte position to grapheme position. Returns the position that contains the given byte index.

pub fn byte_range(&self, bytes: Range<usize>) -> Result<TextRange, TextError>

Byte range to grapheme range.

pub fn str_slice(&self, range: TextRange) -> Result<Cow<'_, str>, TextError>

A range of the text as Cow<str>

pub fn str_slice_byte( &self, range: Range<usize>, ) -> Result<Cow<'_, str>, TextError>

A range of the text as Cow<str>

pub fn cache(&self) -> &Cache

Limited access to the cache. Gives only access to Debug.

pub fn grapheme_at( &self, pos: TextPosition, ) -> Result<Option<Grapheme<'_>>, TextError>

Get the grapheme at the given position.

pub fn text_graphemes( &self, pos: TextPosition, ) -> Result<<Store as TextStore>::GraphemeIter<'_>, TextError>

Get a cursor over all the text with the current position set at pos.

pub fn graphemes( &self, range: TextRange, pos: TextPosition, ) -> Result<<Store as TextStore>::GraphemeIter<'_>, TextError>

Get a cursor over the text-range the current position set at pos.

pub fn graphemes_byte( &self, range: Range<usize>, pos: usize, ) -> Result<<Store as TextStore>::GraphemeIter<'_>, TextError>

Get a cursor over the text-range with the current position set at pos.

pub fn line_at(&self, row: u32) -> Result<Cow<'_, str>, TextError>

Line as str.

• row must be <= len_lines

pub fn lines_at( &self, row: u32, ) -> Result<impl Iterator<Item = Cow<'_, str>>, TextError>

Iterate over text-lines, starting at row.

• row must be <= len_lines

pub fn line_graphemes( &self, row: u32, ) -> Result<<Store as TextStore>::GraphemeIter<'_>, TextError>

Get the text for a line as iterator over the graphemes.

pub fn line_width(&self, row: u32) -> Result<u32, TextError>

Line width as grapheme count. Excludes the terminating ‘\n’.

pub fn len_lines(&self) -> u32

Number of lines.

pub fn len_bytes(&self) -> usize

Length in bytes.

impl<Store> TextCore<Store>

where Store: TextStore + Default,

pub fn clear(&mut self)

Clear the internal state.

pub fn text(&self) -> &Store

Returns the TextStore.

pub fn set_text(&mut self, t: Store) -> bool

Set the text as a TextStore. Clears the styles, cursor and anchor.

pub fn insert_char( &mut self, pos: TextPosition, c: char, ) -> Result<bool, TextError>

Insert a character.

Has no special handling for ‘\n’ and ‘\t’ and just adds them as they are. ‘\n’ is treated as line-break, but it might not be the correct byte-sequence for your platform.

pub fn insert_str( &mut self, pos: TextPosition, t: &str, ) -> Result<bool, TextError>

Insert a string at position.

pub fn remove_char_range(&mut self, range: TextRange) -> Result<bool, TextError>

Remove a range.

Put it into undo as ‘char-removed’. This can merge with other ‘char-removed’ undoes if they are next to each other.

pub fn remove_str_range(&mut self, range: TextRange) -> Result<bool, TextError>

Remove a range

Put it into undo as ‘str-removed’. This will not be merged with other undoes.

Trait Implementations

impl<Store> Clone for TextCore<Store>

where Store: Clone,

fn clone(&self) -> TextCore<Store>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Store> Debug for TextCore<Store>

where Store: Debug,

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

Formats the value using the given formatter.