Struct Label 

pub struct Label {
    id: Id,
    rect: Rectangle,
    children: Vec<Box<dyn View>>,
    text: String,
    align: Align,
    scheme: [Color; 3],
    event: Option<Event>,
    hold_event: Option<Event>,
}

A text label widget that displays a single line of text.

Label is a UI component that renders text with configurable alignment and color scheme. It can optionally respond to tap and hold gestures by emitting events.

Fields

• id - Unique identifier for this view
• rect - The rectangular bounds of the label
• children - Child views (typically empty for labels)
• text - The text content to display
• align - Horizontal alignment of the text (left, center, or right)
• scheme - Color scheme as [background, foreground, border]
• event - Optional event to emit when the label is tapped
• hold_event - Optional event to emit when the label is held

Fields

id: Id

rect: Rectangle

children: Vec<Box<dyn View>>

text: String

align: Align

scheme: [Color; 3]

event: Option<Event>

hold_event: Option<Event>

Implementations

impl Label

pub fn new(rect: Rectangle, text: String, align: Align) -> Label

pub fn event(self, event: Option<Event>) -> Label

Set the tap event for the label.

pub fn hold_event(self, event: Option<Event>) -> Label

Set the hold event for the label.

pub fn scheme(self, scheme: [Color; 3]) -> Label

Set the color scheme for the label.

pub fn update(&mut self, text: &str, rq: &mut RenderQueue)

Update the text content of the label.

pub fn set_scheme(&mut self, scheme: [Color; 3], rq: &mut RenderQueue)

Update the color scheme of the label.

pub fn set_event(&mut self, event: Option<Event>)

Set the tap event for the label (mutable version).

pub fn text(&self) -> &str

Get the current text of the label.

Trait Implementations

impl View for Label

fn handle_event( &mut self, evt: &Event, _hub: &Hub, bus: &mut Bus, _rq: &mut RenderQueue, _context: &mut Context, ) -> bool

Handle events for this label.

Processes tap and hold gestures that occur within the label’s bounds. When a tap gesture is detected and the label has an associated event, that event is pushed to the bus and the event is marked as handled. Similarly, when a hold gesture is detected and the label has an associated hold event, that event is pushed to the bus.

⚠️ Important Note

This label consumes all tap and hold gestures that occur within its bounds. Even if no event is configured, the gesture will still be marked as handled and will not propagate to other views. You must explicitly set an event using .event() or .hold_event() for gestures to be processed. If you want taps to pass through to underlying views, you should not use this label or configure appropriate event handlers.

Arguments

• evt - The event to handle
• _hub - The event hub (unused)
• bus - The event bus where events are pushed
• _rq - The render queue (unused)
• _context - The application context (unused)

Returns

Returns true if the event was handled (consumed), false otherwise.

fn render(&self, fb: &mut dyn Framebuffer, _rect: Rectangle, fonts: &mut Fonts)

Render the label to the framebuffer.

Draws the label’s background rectangle and renders the text content with proper alignment and vertical centering. The text is rendered using the normal font style and the foreground color from the label’s color scheme.

Arguments

• fb - The framebuffer to render to
• _rect - The clipping region (unused)
• fonts - The font manager for text rendering

fn resize( &mut self, rect: Rectangle, _hub: &Hub, _rq: &mut RenderQueue, _context: &mut Context, )

fn rect(&self) -> &Rectangle

fn rect_mut(&mut self) -> &mut Rectangle

fn children(&self) -> &Vec<Box<dyn View>>

fn children_mut(&mut self) -> &mut Vec<Box<dyn View>>

fn id(&self) -> Id

fn render_rect(&self, _rect: &Rectangle) -> Rectangle

fn child(&self, index: usize) -> &dyn View

fn child_mut(&mut self, index: usize) -> &mut dyn View

fn len(&self) -> usize

fn might_skip(&self, _evt: &Event) -> bool

fn might_rotate(&self) -> bool

fn is_background(&self) -> bool

fn view_id(&self) -> Option<ViewId>