Skip to main content

ElidedLine

Struct ElidedLine 

Source
pub struct ElidedLine { /* private fields */ }
Expand description

One line of text fitted to a width, ending in “…” when it is cut.

Text that fits is kept whole. Longer text keeps as much of its start as fits, cut between characters, followed by “…”, so it never ends in a glyph cut in half. A width too narrow even for “…” keeps the first character, which paint clips, so the text never disappears without a trace. Of text with line breaks, the first line is shown, followed by “…”.

Fit the line in measure or arrange and keep it, or fit and paint it in one go with paint_text_line_elided. Give accessibility the full text, not the shown one.

Implementations§

Source§

impl ElidedLine

Source

pub fn new( shaper: &(impl TextShaper + ?Sized), text: &str, style: &TextStyle, max_width: f32, ) -> Self

Fit text on one line max_width wide. An infinite width keeps the whole first line.

Source

pub fn text(&self) -> &str

The text shown: all of it, or its start followed by “…”.

Source

pub fn is_elided(&self) -> bool

Whether some of the text is not shown.

Source

pub fn width(&self) -> f32

The width the shown text takes.

Source

pub fn paint(&self, ctx: &mut PaintCtx, rect: Rect, align: TextAlign)

Paint the line in rect as paint_text_line does, clipped to the rect’s width when even the “…” didn’t fit.

Source

pub fn paint_with_color( &self, ctx: &mut PaintCtx, rect: Rect, align: TextAlign, color: Color, )

Paint like paint, in color instead of the style’s.

Trait Implementations§

Source§

impl Clone for ElidedLine

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ElidedLine

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for ElidedLine

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

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> 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<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

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.