Struct embedded_text::style::TextBoxStyle

#[non_exhaustive]
pub struct TextBoxStyle {
    pub alignment: HorizontalAlignment,
    pub vertical_alignment: VerticalAlignment,
    pub height_mode: HeightMode,
    pub line_height: LineHeight,
    pub paragraph_spacing: u32,
    pub tab_size: TabSize,
}

Styling options of a TextBox.

TextBoxStyle contains the font, foreground and background PixelColor, line spacing, HeightMode, HorizontalAlignment and VerticalAlignment information necessary to draw a TextBox.

To construct a new TextBoxStyle object, use the TextBoxStyle::default method or the TextBoxStyleBuilder object.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

alignment: HorizontalAlignment

Horizontal text alignment.

vertical_alignment: VerticalAlignment

Vertical text alignment.

height_mode: HeightMode

The height behaviour.

line_height: LineHeight

Line height.

paragraph_spacing: u32

Paragraph spacing.

tab_size: TabSize

Desired column width for tabs

Implementations

impl TextBoxStyle

pub const fn default() -> Self

Creates a new text box style object with default settings.

pub const fn with_alignment(alignment: HorizontalAlignment) -> TextBoxStyle

Creates a new text box style with the given alignment.

pub const fn with_vertical_alignment(
    alignment: VerticalAlignment
) -> TextBoxStyle

Creates a new text box style with the given vertical alignment.

impl TextBoxStyle

pub fn measure_text_height<S>(
    &self,
    character_style: &S,
    text: &str,
    max_width: u32
) -> u32 where
    S: TextRenderer,
    S::Color: From<Rgb888>, 

Measures text height when rendered using a given width.

Example: measure height of text when rendered using a 6x8 MonoFont and 72px width.

let character_style = MonoTextStyleBuilder::new()
    .font(&FONT_6X9)
    .text_color(BinaryColor::On)
    .build();
let style = TextBoxStyleBuilder::new().build();

let height = style.measure_text_height(
    &character_style,
    "Lorem Ipsum is simply dummy text of the printing and typesetting industry.",
    72,
);

// Expect 7 lines of text, wrapped in something like the following:

// |Lorem Ipsum |
// |is simply   |
// |dummy text  |
// |of the      |
// |printing and|
// |typesetting |
// |industry.   |

assert_eq!(7 * 9, height);

Trait Implementations

impl Clone for TextBoxStyle

fn clone(&self) -> TextBoxStyle

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TextBoxStyle

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

Formats the value using the given formatter.

impl From<&'_ TextBoxStyle> for TextBoxStyleBuilder

fn from(style: &TextBoxStyle) -> Self

Performs the conversion.

impl Hash for TextBoxStyle

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, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<TextBoxStyle> for TextBoxStyle

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Copy for TextBoxStyle

impl Eq for TextBoxStyle

impl StructuralEq for TextBoxStyle

impl StructuralPartialEq for TextBoxStyle