Struct TextRun 

pub struct TextRun {
    pub len: usize,
    pub font: Font,
    pub color: Hsla,
    pub background_color: Option<Hsla>,
    pub underline: Option<UnderlineStyle>,
    pub strikethrough: Option<StrikethroughStyle>,
    pub letter_spacing: Option<Pixels>,
}

A stretch of text that shares one font and style.

Text layout takes a slice of runs whose len values add up to the length of the text. Each run styles the bytes that follow the runs before it. Runs control how text is shaped and painted, so changing a run’s color, background_color, underline, or strikethrough does not reshape the text.

Examples

let text = "Hello world";
let runs = [
    TextRun {
        len: 6,
        font: font("Lilex"),
        color: hsla(0., 0., 0., 1.),
        ..Default::default()
    },
    TextRun {
        len: 5,
        font: font("Lilex").bold(),
        color: hsla(0., 0., 0., 1.),
        ..Default::default()
    },
];
assert_eq!(runs.iter().map(|run| run.len).sum::<usize>(), text.len());

Fields

len: usize

The number of UTF-8 bytes this run covers.

font: Font

The font to use for this run.

color: Hsla

The color of the glyphs.

background_color: Option<Hsla>

The background color behind the glyphs, or None for no background.

underline: Option<UnderlineStyle>

The underline drawn under the glyphs, or None for no underline.

strikethrough: Option<StrikethroughStyle>

The strikethrough drawn through the glyphs, or None for none.

letter_spacing: Option<Pixels>

The extra space added between glyphs, in logical pixels, or None for no extra space.

Trait Implementations

impl Clone for TextRun

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextRun

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

Formats the value using the given formatter.

impl Default for TextRun

fn default() -> Self

Returns the “default value” for a type.

impl Eq for TextRun

impl From<&TextRun> for PaintStyle

fn from(run: &TextRun) -> Self

Converts to this type from the input type.

impl Hash for TextRun

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TextRun

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TextRun