Struct Label 

pub struct Label { /* private fields */ }

Text, on one line or wrapped to its width, vertically centered in its rectangle.

Implementations

impl Label

pub fn new(text: impl Into<String>) -> Self

text on one line, in the theme’s text color and size.

pub fn dim(self) -> Self

The label in the theme’s secondary text color.

pub fn with_size(self, size: f32) -> Self

The label at size logical pixels instead of the theme’s size.

pub fn wrapping(self) -> Self

The label wrapped onto more lines at the width layout gives it.

pub fn centered(self) -> Self

The label centered horizontally too.

pub fn text(&self) -> &str

The text shown.

pub fn set_text(&mut self, cx: &mut EventCx<'_>, text: impl Into<String>)

Shows text instead, measured again at the next layout.

Trait Implementations

impl Debug for Label

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

Formats the value using the given formatter.

impl Widget for Label

fn accessibility(&self, _: &PaintCx<'_>, node: &mut AccessNode)

Describes the widget to assistive technology: fills node, which starts as a Role::Group with the widget’s rectangle. Called only while assistive technology is listening; it may allocate.

fn measure(&mut self, cx: &mut LayoutCx<'_>, constraints: Constraints) -> Size

The size the widget wants within constraints, for a widget without children (one with children is sized by its style and its children). Physical pixels.

fn layout(&mut self, cx: &mut LayoutCx<'_>, size: Size)

Layout decided the widget’s size: re-wrap text or recompute anything that depends on it. Called after every layout pass that changed the size.

fn paint(&mut self, cx: &PaintCx<'_>, canvas: &mut Canvas<'_>)

Paints the widget below its children.

fn paint_over(&mut self, cx: &PaintCx<'_>, canvas: &mut Canvas<'_>)

Paints the widget over its children: scroll bars, focus rings, overlays.

fn event(&mut self, cx: &mut EventCx<'_>, event: &Event<'_>) -> Handled

Handles event. An event the widget does not handle goes on to its parent.

fn accepts_focus(&self) -> bool

Whether the widget takes keyboard focus, by click or by Tab.

fn focus_on_press(&self) -> bool

Whether a press on the widget, or on a widget inside it that takes no focus, focuses it (if it accepts focus). A container reachable by Tab, such as a dock’s tab list, says no, so clicks on its contents do not focus it; it can still ask for focus itself.

fn access_action( &mut self, cx: &mut EventCx<'_>, request: &AccessRequest<'_>, ) -> Handled

Does what assistive technology asks (only actions the widget’s node lists are asked of it). Focus and scrolling into view are done for every widget; a request the widget does not handle goes on to its parent if it is a scroll.