Struct Button 

pub struct Button {

    pub rect: Rect,
    pub label: String,
    pub label_size: f32,
    pub label_align: ButtonLabelAlign,
    pub bg: ColorLinPremul,
    pub fg: ColorLinPremul,
    pub radius: f32,
    pub focused: bool,
    pub focus_visible: bool,
    pub padding: [f32; 4],
    pub icon_path: Option<String>,
    pub icon_size: f32,
    pub icon_spacing: f32,
    pub icon_only: bool,
    pub focus_id: FocusId,
}

A clickable button with label, optional icon, and focus support.

Fields

rect: Rect

label: String

label_size: f32

label_align: ButtonLabelAlign

bg: ColorLinPremul

fg: ColorLinPremul

radius: f32

focused: bool

focus_visible: bool

padding: [f32; 4]

Padding: [top, right, bottom, left].

icon_path: Option<String>

Optional icon asset path (SVG or raster).

icon_size: f32

Logical icon size in pixels (square).

icon_spacing: f32

Horizontal spacing between icon and label.

icon_only: bool

When true, suppress label rendering (icon-only button).

focus_id: FocusId

Focus identifier for this button.

Implementations

impl Button

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

Create a button with sensible defaults.

pub fn with_theme(label: impl Into<String>, theme: &Theme) -> Self

Create a button that derives its colors from a Theme.

pub fn hit_test(&self, x: f32, y: f32) -> bool

Hit-test: is (x, y) inside the button rect?

Trait Implementations

impl Element for Button

fn rect(&self) -> Rect

The bounding rectangle of this element in logical coordinates.

fn set_rect(&mut self, rect: Rect)

Update the bounding rectangle (typically called by the layout engine).

fn render(&self, canvas: &mut Canvas, z: i32)

Paint this element onto canvas at the given z-index.

fn focus_id(&self) -> Option<FocusId>

The focus identifier for this element, if it is focusable.

impl EventHandler for Button

fn handle_mouse_click(&mut self, event: &MouseClickEvent) -> EventResult

Handle a mouse click event. Returns Handled if the event was consumed.

fn handle_keyboard(&mut self, event: &KeyboardEvent) -> EventResult

Handle a keyboard event. Returns Handled if the event was consumed.

fn handle_mouse_move(&mut self, _event: &MouseMoveEvent) -> EventResult

Handle a mouse-move event.

fn handle_scroll(&mut self, _event: &ScrollEvent) -> EventResult

Handle a scroll event.

fn is_focused(&self) -> bool

Whether this element currently has focus.

fn set_focused(&mut self, focused: bool)

Set focus state for this element.

fn contains_point(&self, x: f32, y: f32) -> bool

Hit-test: does this element contain the given logical point?