Struct Text

pub struct Text { /* private fields */ }

A run of text rendered with a size, colour, alignment and optional font, either word-wrapped or kept on one line with ellipsis truncation.

Implementations

impl Text

pub fn new(content: impl Into<String>) -> Self

A left-aligned, non-wrapping, ellipsis-truncated white label at the default 16 px size with the canvas default font.

pub fn no_truncate(self) -> Self

Paint the full string even when it overflows, instead of truncating with an ellipsis.

pub fn font( self, family: impl Into<String>, weight: u16, style: FontStyle, ) -> Self

Set a (family, weight, style) override for this text node. The triple is resolved through Canvas::font_for at draw time, so missing weights fall through the registry’s nearest- match precedence.

pub fn weight(self, weight: u16) -> Self

Shorthand for Self::font when the desired override is just a weight on the default Sora family (the family ltk-theme- default declares).

pub fn size(self, s: impl Into<Length>) -> Self

Set the font size.

pub fn color(self, c: Color) -> Self

Set the text colour.

pub fn align(self, a: TextAlign) -> Self

Set the horizontal alignment.

pub fn align_center(self) -> Self

Shorthand for Self::align with TextAlign::Center.

pub fn wrap(self, w: bool) -> Self

Enable word-wrapping. With wrap = true the text breaks on whitespace at max_width and the widget reports the natural height of all the resulting lines. With wrap = false (the default) the text stays on one line and is truncated with an ellipsis when it overflows.

pub fn preferred_size(&self, max_width: f32, canvas: &Canvas) -> (f32, f32)

pub fn draw(&self, canvas: &mut Canvas, rect: Rect, _focused: bool)

Trait Implementations

impl<Msg: Clone + 'static> From<Text> for Element<Msg>

fn from(t: Text) -> Self

Converts to this type from the input type.