Struct ToolbarItem 

pub struct ToolbarItem { /* private fields */ }

One slot in a Toolbar.

Implementations

impl ToolbarItem

pub fn action(action: ToolbarAction) -> Self

A collapsible command.

pub fn custom(widget: impl Widget + 'static) -> Self

A pinned arbitrary widget (never collapses) — e.g. a search field. Make it collapsible with overflow_as.

pub fn custom_id(id: WidgetId) -> Self

A pinned arbitrary widget by pre-registered id.

pub fn collapsible(widget: impl Widget + ToolbarOverflow + 'static) -> Self

A collapsible widget that supplies its own menu form via ToolbarOverflow. When the bar is too narrow, the widget is hidden and its toolbar_menu_form() appears in the overflow menu.

pub fn overflow_as(self, menu_form: ToolbarAction) -> Self

Make a custom widget collapsible with an explicit menu row — the ToolbarAction shown when it overflows (NSToolbar menuFormRepresentation). Best for controls whose menu form is a single command; an icon-only inline control reuses its icon here as the menu item’s leading glyph (pass it to ToolbarAction::new).

pub fn overflow_widget( self, factory: impl Fn() -> Box<dyn Widget> + 'static, ) -> Self

Make a custom widget collapsible by embedding a live widget in the overflow menu — the factory rebuilds the control (e.g. a ComboBox bound to the same signal) so it stays fully interactive while collapsed, instead of degrading to a one-shot menu row. Best for stateful inputs (combo boxes, sliders) that have no meaningful single “command” representation.

pub fn separator() -> Self

A separator line between groups.

pub fn flexible_space() -> Self

Flexible space that pushes the following items to the trailing edge (NSToolbar flexibleSpace). Collapses to nothing when over-constrained.