Struct Titlebar 

#[repr(C)]
pub struct Titlebar {
    pub title: AzString,
    pub height: f32,
    pub font_size: f32,
    pub padding_left: f32,
    pub padding_right: f32,
    pub title_color: ColorU,
}

A titlebar widget with optional close / minimize / maximize buttons, drag-to-move, and double-click-to-maximize.

Two modes

1. Title-only (Titlebar::dom, the default for WindowDecorations::NoTitleAutoInject): The OS still draws the native window-control buttons (traffic lights on macOS, caption buttons on Windows). The titlebar reserves padding_left / padding_right so the title text doesn’t overlap them.

2. Full CSD (Titlebar::dom_with_buttons, used when WindowDecorations::None + has_decorations): The titlebar renders its own close / minimize / maximize buttons as regular DOM nodes. Each button carries a plain MouseDown callback that calls CallbackInfo::modify_window_state() — exactly the same mechanism used for window dragging. No special event-system hooks.

Window-control buttons use Dom::create_icon("close") etc. so that icons are resolved through the icon provider system (Material Icons by default) and can be swapped out by registering a different icon pack.

Button layout

button_side controls where the buttons appear:

• Left — macOS traffic-light style (buttons before title)
• Right — Windows / Linux style (title then buttons)

Styling

The DOM uses CSS classes .csd-titlebar, .csd-title, .csd-buttons, .csd-button, .csd-close, .csd-minimize, .csd-maximize. These match the output of SystemStyle::create_csd_stylesheet().

Fields

title: AzString

The title text to display.

height: f32

Height of the titlebar in CSS pixels.

font_size: f32

Font size for the title text in CSS pixels.

padding_left: f32

Extra padding on the left side (px).

padding_right: f32

Extra padding on the right side (px).

title_color: ColorU

Title text color (resolved from SystemStyle.colors.text or platform default).

Implementations

impl Titlebar

pub fn new(title: AzString) -> Self

Create a titlebar with compile-time platform defaults.

Use Titlebar::from_system_style when you have a SystemStyle available for pixel-perfect metrics.

pub fn create(title: AzString) -> Self

FFI-compatible alias for Titlebar::new.

pub fn with_height(title: AzString, height: f32) -> Self

Create a titlebar with a custom height.

pub fn set_height(&mut self, height: f32)

Set the titlebar height.

pub fn set_title(&mut self, title: AzString)

Set the title text.

pub fn swap_with_default(&mut self) -> Self

Swap this titlebar with a default instance, returning the old value.

pub fn from_system_style(title: AzString, system_style: &SystemStyle) -> Self

Create from a live SystemStyle (for title-only mode, padding reserves space for OS-drawn buttons).

pub fn from_system_style_csd( title: AzString, system_style: &SystemStyle, ) -> Self

Create from SystemStyle for full CSD mode (no padding — the buttons are rendered as DOM children).

pub fn dom(self) -> Dom

Title-only DOM (for NoTitleAutoInject).

The OS draws the native window-control buttons; this just renders a centred title with drag support.

pub fn dom_with_buttons( self, buttons: &TitlebarButtons, button_side: TitlebarButtonSide, ) -> Dom

Full-CSD DOM with close / minimize / maximize buttons.

Each button is a div with a MouseDown callback that calls modify_window_state() — no special hooks needed.

Trait Implementations

impl Clone for Titlebar

fn clone(&self) -> Titlebar

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Titlebar

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

Formats the value using the given formatter.

impl Default for Titlebar

fn default() -> Self

Returns the “default value” for a type.

impl From<Titlebar> for Dom

fn from(t: Titlebar) -> Dom

Converts to this type from the input type.

impl PartialEq for Titlebar

fn eq(&self, other: &Titlebar) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Titlebar

fn partial_cmp(&self, other: &Titlebar) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Titlebar