Struct WindowButton

pub struct WindowButton<Msg: Clone> {
    pub kind: WindowButtonKind,
    pub on_press: Option<Msg>,
    pub size: f32,
    pub id: Option<WidgetId>,
    pub focusable: bool,
}

Button styled for compositor / window decorations.

The widget is intentionally policy-free: it paints a standard control and emits the message supplied by the caller. Forge remains responsible for deciding what that message does to the window.

Fields

kind: WindowButtonKind

Which decoration role this button paints.

on_press: Option<Msg>

Message emitted on activation. None greys the button and skips the hover / pressed surface — useful for “maximize disabled” on fixed-size windows.

size: f32

Square hit-target size in logical pixels. Clamped to a 20 px floor by Self::size so the button stays touchable.

id: Option<WidgetId>

Optional stable identifier for focus management.

focusable: bool

Whether this button takes part in the Tab / Shift+Tab cycle. Defaults to false to match desktop convention — title-bar chrome on macOS, GNOME and Windows is click/touch-only and never steals keyboard focus from window content. Opt in with Self::focusable for shells where keyboard reachability of decorations matters (accessibility, no-mouse kiosks). Pointer / touch hit testing is unaffected by this flag.

Implementations

impl<Msg: Clone> WindowButton<Msg>

pub fn new(kind: WindowButtonKind) -> Self

Create a window-decoration button of the given kind. The button is inert (no callback) until Self::on_press is configured.

pub fn on_press(self, msg: Msg) -> Self

Set the message emitted when the button is activated.

pub fn on_press_maybe(self, msg: Option<Msg>) -> Self

Like Self::on_press but keeps the disabled state when None is passed — useful when the message depends on a runtime condition (e.g. maximize is disabled for fixed-size windows).

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

Override the square hit-target size in logical pixels. Clamped to a 20 px floor so the button remains touchable.

pub fn id(self, id: WidgetId) -> Self

Assign a stable identifier for focus management.

pub fn focusable(self, yes: bool) -> Self

Opt into keyboard focus traversal. Defaults to false so the button does not steal Tab focus from window content.

pub fn preferred_size(&self, max_width: f32, _canvas: &Canvas) -> (f32, f32)

pub fn paint_bounds(&self, rect: Rect) -> Rect

pub fn draw( &self, canvas: &mut Canvas, rect: Rect, focused: bool, hovered: bool, pressed: bool, )

Trait Implementations

impl<Msg: Clone + 'static> From<WindowButton<Msg>> for Element<Msg>

fn from(b: WindowButton<Msg>) -> Self

Converts to this type from the input type.