Struct embedded_text::TextBox

pub struct TextBox<'a, S, M = NoPlugin<<S as TextRenderer>::Color>> where
    S: TextRenderer,  {
    pub text: &'a str,
    pub bounds: Rectangle,
    pub character_style: S,
    pub style: TextBoxStyle,
    pub vertical_offset: i32,
    // some fields omitted
}

A text box object.

The TextBox struct represents a piece of text that can be drawn on a display inside the given bounding box.

Use the draw method to draw the text box on a display.

See the module-level documentation for more information.

Fields

text: &'a str

The text to be displayed in this TextBox

bounds: Rectangle

The bounding box of this TextBox

character_style: S

The character style of the TextBox.

style: TextBoxStyle

The style of the TextBox.

vertical_offset: i32

Vertical offset applied to the text just before rendering.

Implementations

impl<'a, S> TextBox<'a, S, NoPlugin<<S as TextRenderer>::Color>> where
    <S as TextRenderer>::Color: From<Rgb888>,
    S: TextRenderer + CharacterStyle, 

pub fn new(text: &'a str, bounds: Rectangle, character_style: S) -> Self

Creates a new TextBox instance with a given bounding Rectangle.

pub fn with_textbox_style(
    text: &'a str,
    bounds: Rectangle,
    character_style: S,
    textbox_style: TextBoxStyle
) -> Self

Creates a new TextBox instance with a given bounding Rectangle and a given TextBoxStyle.

pub fn with_alignment(
    text: &'a str,
    bounds: Rectangle,
    character_style: S,
    alignment: HorizontalAlignment
) -> Self

Creates a new TextBox instance with a given bounding Rectangle and a given TextBoxStyle.

pub fn with_vertical_alignment(
    text: &'a str,
    bounds: Rectangle,
    character_style: S,
    vertical_alignment: VerticalAlignment
) -> Self

Creates a new TextBox instance with a given bounding Rectangle and a given TextBoxStyle.

pub fn set_vertical_offset(&mut self, offset: i32) -> &mut Self

Sets the vertical text offset.

impl<'a, S, M> TextBox<'a, S, M> where
    S: TextRenderer,
    M: Plugin<'a, S::Color>,
    S::Color: From<Rgb888>, 

pub fn fit_height(&mut self) -> &mut Self

Sets the height of the TextBox to the height of the text.

pub fn fit_height_limited(&mut self, max_height: u32) -> &mut Self

Sets the height of the TextBox to the height of the text, limited to max_height.

This method allows you to set a maximum height. The TextBox will take up at most max_height pixel vertical space.

Trait Implementations

impl<'a, S: Clone, M: Clone> Clone for TextBox<'a, S, M> where
    S: TextRenderer,
    S::Color: Clone, 

fn clone(&self) -> TextBox<'a, S, M>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, S: Debug, M: Debug> Debug for TextBox<'a, S, M> where
    S: TextRenderer,
    S::Color: Debug, 

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

Formats the value using the given formatter.

impl<'a, S, M> Dimensions for TextBox<'a, S, M> where
    S: TextRenderer,
    M: Plugin<'a, S::Color>, 

fn bounding_box(&self) -> Rectangle

Returns the bounding box.

impl<'a, F, M> Drawable for TextBox<'a, F, M> where
    F: TextRenderer<Color = <F as CharacterStyle>::Color> + CharacterStyle,
    <F as CharacterStyle>::Color: From<Rgb888>,
    M: Plugin<'a, <F as TextRenderer>::Color> + Plugin<'a, <F as CharacterStyle>::Color>, 

type Color = <F as CharacterStyle>::Color

The pixel color type.

type Output = &'a str

The return type of the draw method.

fn draw<D: DrawTarget<Color = Self::Color>>(
    &self,
    display: &mut D
) -> Result<&'a str, D::Error>

Draw the graphics object using the supplied DrawTarget.

impl<'a, S: Hash, M: Hash> Hash for TextBox<'a, S, M> where
    S: TextRenderer,
    S::Color: Hash, 

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<'a, S, M> Transform for TextBox<'a, S, M> where
    S: TextRenderer + Clone,
    M: Plugin<'a, S::Color>, 

fn translate(&self, by: Point) -> Self

Move the origin of an object by a given number of (x, y) pixels, returning a new object

fn translate_mut(&mut self, by: Point) -> &mut Self

Move the origin of an object by a given number of (x, y) pixels, mutating the object in place