Skip to main content

TextView

Struct TextView 

Source
pub struct TextView<'a> {
    pub frame: Rectangle,
    pub text: &'a str,
    pub style: TextRunStyle,
    pub view_style: TextViewStyle,
}
Expand description

Simple text view that renders one string with one style.

Fields§

§frame: Rectangle

Outer frame for the text view.

§text: &'a str

Plain text content.

§style: TextRunStyle

Style for the whole text string.

§view_style: TextViewStyle

Container-level layout and shell styling.

Implementations§

Source§

impl<'a> TextView<'a>

Source

pub const fn new(frame: Rectangle, text: &'a str, style: TextRunStyle) -> Self

Creates a plain text view.

Examples found in repository?
examples/text_and_image.rs (lines 38-42)
15fn main() {
16    let mut canvas = support::NullCanvas::new(Size::new(320, 240));
17
18    let image_data = [
19        0xF8, 0x00, 0x07, 0xE0, //
20        0x07, 0xE0, 0xF8, 0x00, //
21    ];
22    let image: ImageRawBE<Rgb565> = ImageRaw::new(&image_data, 2);
23
24    ImageView::new(
25        Rectangle::new(Point::new(16, 16), Size::new(72, 72)),
26        &image,
27    )
28    .with_style(
29        ImageViewStyle::new()
30            .with_alignment(ImageAlignment::Center)
31            .with_insets(EdgeInsets::all(8))
32            .with_background(Rgb565::new(28, 58, 28))
33            .with_border(Rgb565::new(20, 44, 20), 2)
34            .with_corner_radius(12),
35    )
36    .draw(&mut canvas);
37
38    TextView::new(
39        Rectangle::new(Point::new(104, 18), Size::new(192, 28)),
40        "Faststep",
41        TextRunStyle::title(Rgb565::BLACK),
42    )
43    .with_view_style(
44        TextViewStyle::new()
45            .with_alignment(TextAlignment::Leading)
46            .with_vertical_alignment(TextVerticalAlignment::Center),
47    )
48    .draw(&mut canvas);
49
50    let spans = [
51        TextSpan::new("UIKit-like ", TextRunStyle::body(Rgb565::BLACK)),
52        TextSpan::new("embedded UI", TextRunStyle::body_strong(Rgb565::BLUE)),
53        TextSpan::new(
54            "\nfor devices and simulators",
55            TextRunStyle::caption(Rgb565::GREEN),
56        ),
57    ];
58    RichTextView::new(
59        Rectangle::new(Point::new(104, 58), Size::new(192, 72)),
60        &spans,
61    )
62    .with_view_style(
63        TextViewStyle::new()
64            .with_wrap(TextWrap::Multiline)
65            .with_insets(EdgeInsets::all(4)),
66    )
67    .draw(&mut canvas);
68}
Source

pub fn with_view_style(self, view_style: TextViewStyle) -> Self

Replaces the container style.

Examples found in repository?
examples/text_and_image.rs (lines 43-47)
15fn main() {
16    let mut canvas = support::NullCanvas::new(Size::new(320, 240));
17
18    let image_data = [
19        0xF8, 0x00, 0x07, 0xE0, //
20        0x07, 0xE0, 0xF8, 0x00, //
21    ];
22    let image: ImageRawBE<Rgb565> = ImageRaw::new(&image_data, 2);
23
24    ImageView::new(
25        Rectangle::new(Point::new(16, 16), Size::new(72, 72)),
26        &image,
27    )
28    .with_style(
29        ImageViewStyle::new()
30            .with_alignment(ImageAlignment::Center)
31            .with_insets(EdgeInsets::all(8))
32            .with_background(Rgb565::new(28, 58, 28))
33            .with_border(Rgb565::new(20, 44, 20), 2)
34            .with_corner_radius(12),
35    )
36    .draw(&mut canvas);
37
38    TextView::new(
39        Rectangle::new(Point::new(104, 18), Size::new(192, 28)),
40        "Faststep",
41        TextRunStyle::title(Rgb565::BLACK),
42    )
43    .with_view_style(
44        TextViewStyle::new()
45            .with_alignment(TextAlignment::Leading)
46            .with_vertical_alignment(TextVerticalAlignment::Center),
47    )
48    .draw(&mut canvas);
49
50    let spans = [
51        TextSpan::new("UIKit-like ", TextRunStyle::body(Rgb565::BLACK)),
52        TextSpan::new("embedded UI", TextRunStyle::body_strong(Rgb565::BLUE)),
53        TextSpan::new(
54            "\nfor devices and simulators",
55            TextRunStyle::caption(Rgb565::GREEN),
56        ),
57    ];
58    RichTextView::new(
59        Rectangle::new(Point::new(104, 58), Size::new(192, 72)),
60        &spans,
61    )
62    .with_view_style(
63        TextViewStyle::new()
64            .with_wrap(TextWrap::Multiline)
65            .with_insets(EdgeInsets::all(4)),
66    )
67    .draw(&mut canvas);
68}
Source

pub fn draw<D>(&self, display: &mut D)
where D: DrawTarget<Color = Rgb565>,

Draws the text view.

Examples found in repository?
examples/text_and_image.rs (line 48)
15fn main() {
16    let mut canvas = support::NullCanvas::new(Size::new(320, 240));
17
18    let image_data = [
19        0xF8, 0x00, 0x07, 0xE0, //
20        0x07, 0xE0, 0xF8, 0x00, //
21    ];
22    let image: ImageRawBE<Rgb565> = ImageRaw::new(&image_data, 2);
23
24    ImageView::new(
25        Rectangle::new(Point::new(16, 16), Size::new(72, 72)),
26        &image,
27    )
28    .with_style(
29        ImageViewStyle::new()
30            .with_alignment(ImageAlignment::Center)
31            .with_insets(EdgeInsets::all(8))
32            .with_background(Rgb565::new(28, 58, 28))
33            .with_border(Rgb565::new(20, 44, 20), 2)
34            .with_corner_radius(12),
35    )
36    .draw(&mut canvas);
37
38    TextView::new(
39        Rectangle::new(Point::new(104, 18), Size::new(192, 28)),
40        "Faststep",
41        TextRunStyle::title(Rgb565::BLACK),
42    )
43    .with_view_style(
44        TextViewStyle::new()
45            .with_alignment(TextAlignment::Leading)
46            .with_vertical_alignment(TextVerticalAlignment::Center),
47    )
48    .draw(&mut canvas);
49
50    let spans = [
51        TextSpan::new("UIKit-like ", TextRunStyle::body(Rgb565::BLACK)),
52        TextSpan::new("embedded UI", TextRunStyle::body_strong(Rgb565::BLUE)),
53        TextSpan::new(
54            "\nfor devices and simulators",
55            TextRunStyle::caption(Rgb565::GREEN),
56        ),
57    ];
58    RichTextView::new(
59        Rectangle::new(Point::new(104, 58), Size::new(192, 72)),
60        &spans,
61    )
62    .with_view_style(
63        TextViewStyle::new()
64            .with_wrap(TextWrap::Multiline)
65            .with_insets(EdgeInsets::all(4)),
66    )
67    .draw(&mut canvas);
68}

Auto Trait Implementations§

§

impl<'a> Freeze for TextView<'a>

§

impl<'a> RefUnwindSafe for TextView<'a>

§

impl<'a> Send for TextView<'a>

§

impl<'a> Sync for TextView<'a>

§

impl<'a> Unpin for TextView<'a>

§

impl<'a> UnsafeUnpin for TextView<'a>

§

impl<'a> UnwindSafe for TextView<'a>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Az for T

Source§

fn az<Dst>(self) -> Dst
where T: Cast<Dst>,

Casts the value.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<Src, Dst> CastFrom<Src> for Dst
where Src: Cast<Dst>,

Source§

fn cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> CheckedAs for T

Source§

fn checked_as<Dst>(self) -> Option<Dst>
where T: CheckedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> CheckedCastFrom<Src> for Dst
where Src: CheckedCast<Dst>,

Source§

fn checked_cast_from(src: Src) -> Option<Dst>

Casts the value.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> OverflowingAs for T

Source§

fn overflowing_as<Dst>(self) -> (Dst, bool)
where T: OverflowingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> OverflowingCastFrom<Src> for Dst
where Src: OverflowingCast<Dst>,

Source§

fn overflowing_cast_from(src: Src) -> (Dst, bool)

Casts the value.
Source§

impl<T> SaturatingAs for T

Source§

fn saturating_as<Dst>(self) -> Dst
where T: SaturatingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> SaturatingCastFrom<Src> for Dst
where Src: SaturatingCast<Dst>,

Source§

fn saturating_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> UnwrappedAs for T

Source§

fn unwrapped_as<Dst>(self) -> Dst
where T: UnwrappedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> UnwrappedCastFrom<Src> for Dst
where Src: UnwrappedCast<Dst>,

Source§

fn unwrapped_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> WrappingAs for T

Source§

fn wrapping_as<Dst>(self) -> Dst
where T: WrappingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> WrappingCastFrom<Src> for Dst
where Src: WrappingCast<Dst>,

Source§

fn wrapping_cast_from(src: Src) -> Dst

Casts the value.