Struct Text 

pub struct Text<'a> { /* private fields */ }

A single line of text in one Style, clipped (not wrapped) to area.width() columns. Only the first row of area is used.

The plain-content cousin of PrintLine (which prints a multi-span Line, for mixed styling within one line) and Paragraph (which word-wraps across multiple lines): reach for Text for a single already-one-line label or readout in a single style, with no wrapping and no per-span styling. style defaults to Style::new() and align to Align::Left; set them with Text::style/Text::align.

Unlike super::BoxBorder, super::Gauge, super::StatBar, super::Table, and super::Button, Text has no theme()/ theme_on() pair: a line of plain text has no single semantic Theme role to map onto, so callers set style directly.

Examples

use retroglyph_core::grid::{Grid, Rect};
use retroglyph_ui::{Align, Surface, Text, Widget};

let area = Rect::new(0, 0, 10, 1);
let mut grid = Grid::new(10, 1);
Text::new("OK")
    .align(Align::Right)
    .render(&mut Surface::new(&mut grid, area, 0));

Implementations

impl<'a> Text<'a>

pub fn new(content: &'a str) -> Self

A line of content in the default style, left-aligned.

pub const fn style(self, style: Style) -> Self

Set the text’s style.

pub const fn align(self, align: Align) -> Self

Set how the line is aligned within area.width() columns.

Trait Implementations

impl<'a> Clone for Text<'a>

fn clone(&self) -> Text<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Text<'a>

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

Formats the value using the given formatter.

impl Widget for Text<'_>

fn render(&self, surface: &mut Surface<'_>)

Draw this widget into surface, filling surface.area().

impl<'a> Copy for Text<'a>