Struct cosmic_text::BufferLine

pub struct BufferLine { /* private fields */ }

A line (or paragraph) of text that is shaped and laid out

Implementations

impl BufferLine

pub fn new<T: Into<String>>( text: T, attrs_list: AttrsList, shaping: Shaping ) -> Self

Create a new line with the given text and attributes list Cached shaping and layout can be done using the Self::shape and Self::layout functions

pub fn text(&self) -> &str

Get current text

pub fn set_text<T: AsRef<str>>( &mut self, text: T, attrs_list: AttrsList ) -> bool

Set text and attributes list

Will reset shape and layout if it differs from current text and attributes list. Returns true if the line was reset

pub fn into_text(self) -> String

Consume this line, returning only its text contents as a String.

pub fn attrs_list(&self) -> &AttrsList

Get attributes list

pub fn set_attrs_list(&mut self, attrs_list: AttrsList) -> bool

Set attributes list

Will reset shape and layout if it differs from current attributes list. Returns true if the line was reset

pub fn wrap(&self) -> Wrap

Get wrapping setting (wrap by characters/words or no wrapping)

pub fn set_wrap(&mut self, wrap: Wrap) -> bool

Set wrapping setting (wrap by characters/words or no wrapping)

Will reset shape and layout if it differs from current wrapping setting. Returns true if the line was reset

pub fn align(&self) -> Option<Align>

Get the Text alignment

pub fn set_align(&mut self, align: Option<Align>) -> bool

Set the text alignment

Will reset shape and layout if it differs from current alignment. Setting to None will use Align::Right for RTL lines, and Align::Left for LTR lines. Returns true if the line was reset

pub fn append(&mut self, other: Self)

Append line at end of this line

The wrap setting of the appended line will be lost

pub fn split_off(&mut self, index: usize) -> Self

Split off new line at index

pub fn reset(&mut self)

Reset shaping and layout information

pub fn reset_layout(&mut self)

Reset only layout information

pub fn is_reset(&self) -> bool

Check if shaping and layout information is cleared

pub fn shape(&mut self, font_system: &mut FontSystem) -> &ShapeLine

Shape line, will cache results

pub fn shape_opt(&self) -> &Option<ShapeLine>

Get line shaping cache

pub fn layout( &mut self, font_system: &mut FontSystem, font_size: f32, width: f32, wrap: Wrap ) -> &[LayoutLine]

Layout line, will cache results

pub fn layout_opt(&self) -> &Option<Vec<LayoutLine>>

Get line layout cache