Struct zng_wgt_text :: TextSpacingMix Copy item path

impl TextSpacingMix<()>

pub fn context_vars_set(set: &mut ContextValueSet)

Insert context variables used by properties in this mix-in.

impl<P: WidgetImpl> TextSpacingMix

pub fn line_height(&self, height: impl IntoVar<LineHeight>)

P Height of each text line. If not set inherits the line_height from the parent widget.

The Default value is computed from the font metrics, ascent - descent + line_gap, this is usually similar to 1.2.em(). Relative values are computed from the default value, so 200.pct() is double the default line height.

The text is vertically centered inside the height.

Sets the LINE_HEIGHT_VAR.

impl<P: WidgetImpl> TextSpacingMix

pub fn letter_spacing(&self, extra: impl IntoVar<LetterSpacing>)

P Extra spacing added in between text letters. If not set inherits the letter_spacing from the parent widget.

Letter spacing is computed using the font data, this unit represents extra space added to the computed spacing.

A “letter” is a character glyph cluster, e.g.: a, â, 1, -, 漢.

The Default value signals that letter spacing can be tweaked when text justification is enabled, all other values disable automatic adjustments for justification inside words.

Relative values are computed from the length of the space ' ' character.

This property sets the LETTER_SPACING_VAR context var that affects all inner texts.

impl<P: WidgetImpl> TextSpacingMix

pub fn line_spacing(&self, extra: impl IntoVar<LineSpacing>)

P Extra spacing in-between text lines. If not set inherits the line_spacing from the parent widget.

The Default value is zero. Relative values are calculated from the LineHeight, so 50.pct() is half the computed line height. If the text only has one line this property is not used.

Sets the LINE_SPACING_VAR.

impl<P: WidgetImpl> TextSpacingMix

pub fn word_spacing(&self, extra: impl IntoVar<WordSpacing>)

P Extra spacing added to the Unicode U+0020 SPACE character. If not set inherits the word_spacing from the parent widget.

Word spacing is done using the space character “advance” as defined in the font, this unit represents extra spacing added to that default spacing.

A “word” is the sequence of characters in-between space characters. This extra spacing is applied per space character not per word, if there are three spaces between words the extra spacing is applied thrice. Usually the number of spaces between words is collapsed to one, see WhiteSpace, resulting in only one extra spacing.

The Default value signals that word spacing can be tweaked when text justification is enabled, all other values disable automatic adjustments for justification. Relative values are computed from the length of the space ' ' character, so a word spacing of 100.pct() visually adds another space in between words.

This property sets the WORD_SPACING_VAR context var that affects all inner widgets.

impl<P: WidgetImpl> TextSpacingMix

pub fn tab_length(&self, length: impl IntoVar<TabLength>)

P Length of the TAB character space, relative to the normal space advance.

Is set to 400.pct() by default, so 4 times a space.

Sets the TAB_LENGTH_VAR.

Trait Implementations§

impl Deref for TextSpacingMix

type Target = P

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for TextSpacingMix

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

Auto Trait Implementations§

impl UnwindSafe for TextSpacingMix
where P: UnwindSafe,

Blanket Implementations§

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

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

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

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

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

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

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

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

fn into(self) -> U

Calls U::from(self).

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

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more