Struct ToolbarItem 

pub struct ToolbarItem {
    pub id: String,
    pub kind: ToolbarItemKind,
    pub label: String,
    pub tooltip: Option<String>,
    pub icon: Option<Icon>,
    pub enabled: bool,
    pub action: u64,
    pub placement: ToolbarPlacement,
    pub label_style: LabelStyle,
    pub prominent: bool,
    pub column: ToolbarColumn,
}

One item in a window’s toolbar (docs/toolbars.md).

Fields

id: String

Stable identity: the native item identifier, the dayscript target, and the key a ToolbarPatch addresses. Unique within a toolbar.

kind: ToolbarItemKind

label: String

The item’s name. Shown beside or below the icon where the platform does that, and used verbatim in the overflow and customization menus, so it is never optional, even on a toolbar that only shows icons. It is also the item’s accessible name.

tooltip: Option<String>

Hover help. Defaults to label where the platform expects a tooltip and none is given.

icon: Option<Icon>

enabled: bool

action: u64

The item’s command, as a dispatch id from the same registry Event::MenuAction uses (0 = no command), so a toolbar button and its menu twin can share one closure.

placement: ToolbarPlacement

This item’s role on the chrome carrying it (docs/toolbars.md). It never names a surface: Which chrome an item rides is decided by where the app declared it, so this says only where on that chrome it belongs.

label_style: LabelStyle

Whether the item draws its title, its icon, or both, where the platform can do more than one. An item folded into an overflow menu shows its title whatever this asks for; a menu row with no words is not a menu row.

prominent: bool

Draw this item in the platform’s emphasized style (a tinted/filled bar button, a prominent NSToolbarItem). For the one action a chrome is really offering.

column: ToolbarColumn

Which column of a multi-pane window this item came from (docs/toolbars.md), set by Day from the piece that declared it, never by an app.

A desktop toolbar spans every column at once, and a three-pane app expects each column’s commands to sit over that column: the sidebar’s against the first divider, the list’s over the list, the rest over the detail. That is what Mail, Notes and Finder do, and it is only expressible because the declaration site already said which pane the command belongs to. Backends that draw one undivided bar ignore it.

Trait Implementations

impl Clone for ToolbarItem

fn clone(&self) -> ToolbarItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolbarItem

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

Formats the value using the given formatter.

impl PartialEq for ToolbarItem

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ToolbarItem