Struct embedded_text::style::builder::TextBoxStyleBuilder

pub struct TextBoxStyleBuilder<C, F, A, V, H> where
    C: PixelColor,
    F: Font + Copy,
    A: HorizontalTextAlignment,
    V: VerticalTextAlignment,
    H: HeightMode,  { /* fields omitted */ }

TextBoxStyle builder object.

Implementations

impl<C, F> TextBoxStyleBuilder<C, F, LeftAligned, TopAligned, Exact<FullRowsOnly>> where
    C: PixelColor,
    F: Font + Copy, 

#[must_use]pub fn new(font: F) -> Self

Creates a new TextBoxStyleBuilder with a given font.

Default settings are:

• LeftAligned
• TopAligned
• Text color: transparent
• Background color: transparent
• Height mode: Exact
• Line spacing: 0px

#[must_use]pub fn from_text_style(text_style: TextStyle<C, F>) -> Self

Creates a TextBoxStyleBuilder from existing TextStyle object.

Example

use embedded_text::prelude::*;
use embedded_graphics::{fonts::Font6x8, pixelcolor::BinaryColor, style::TextStyleBuilder};

let text_style = TextStyleBuilder::new(Font6x8)
    .background_color(BinaryColor::On)
    .build();

let style = TextBoxStyleBuilder::from_text_style(text_style)
    .build();

impl<C, F, A, V, H> TextBoxStyleBuilder<C, F, A, V, H> where
    C: PixelColor,
    F: Font + Copy,
    A: HorizontalTextAlignment,
    V: VerticalTextAlignment,
    H: HeightMode, 

#[must_use]pub fn text_color(self, text_color: C) -> Self

Sets the text color.

Note: once the text color is set, there is no way to reset it to transparent.

Example: text with transparent background.

use embedded_text::prelude::*;
use embedded_graphics::{fonts::Font6x8, pixelcolor::BinaryColor};

let style = TextBoxStyleBuilder::new(Font6x8)
    .text_color(BinaryColor::On)
    .build();

#[must_use]pub fn line_spacing(self, line_spacing: i32) -> Self

Sets the vertical space between lines, in pixels.

Note: You can set negative values as line spacing if you wish your lines to overlap.

Example

use embedded_text::prelude::*;
use embedded_graphics::{fonts::Font6x8, pixelcolor::BinaryColor};

let style = TextBoxStyleBuilder::new(Font6x8)
    .text_color(BinaryColor::On)
    .line_spacing(3)
    .build();

#[must_use]pub fn background_color(self, background_color: C) -> Self

Sets the background color.

Note: once the background color is set, there is no way to reset it to transparent.

Example: transparent text with background.

use embedded_text::prelude::*;
use embedded_graphics::{fonts::Font6x8, pixelcolor::BinaryColor};

let style = TextBoxStyleBuilder::new(Font6x8)
    .background_color(BinaryColor::On)
    .build();

#[must_use]pub fn text_style(self, text_style: TextStyle<C, F>) -> Self

👎 Deprecated

Copies properties from an existing text style object.

Example

use embedded_text::prelude::*;
use embedded_graphics::{fonts::Font6x8, pixelcolor::BinaryColor, style::TextStyleBuilder};

let text_style = TextStyleBuilder::new(Font6x8)
    .background_color(BinaryColor::On)
    .build();

let style = TextBoxStyleBuilder::new(Font6x8)
    .text_style(text_style)
    .build();

This method has been deprecated and will be removed in a later release. Use TextBoxStyleBuilder::from_text_style instead.

#[must_use]pub fn alignment<TA: HorizontalTextAlignment>(
    self,
    alignment: TA
) -> TextBoxStyleBuilder<C, F, TA, V, H>

Sets the horizontal text alignment.

#[must_use]pub fn vertical_alignment<VA: VerticalTextAlignment>(
    self,
    vertical_alignment: VA
) -> TextBoxStyleBuilder<C, F, A, VA, H>

Sets the vertical text alignment.

#[must_use]pub fn height_mode<HM: HeightMode>(
    self,
    height_mode: HM
) -> TextBoxStyleBuilder<C, F, A, V, HM>

Sets the height mode.

#[must_use]pub fn build(self) -> TextBoxStyle<C, F, A, V, H>

Builds the TextBoxStyle.