Enum MenuItem 

pub enum MenuItem {
    Action {
        label: String,
        action: Rc<dyn Fn()>,
        icon: Option<Icon>,
        checked: Option<bool>,
        destructive: bool,
        enabled: bool,
        shortcut: Option<Shortcut>,
        submenu: Option<Vec<MenuItem>>,
    },
    Separator,
}

Separators are purely visual and ignored by ContextMenu::click_item.

Variants

Action

Fields

label: String

action: Rc<dyn Fn()>

icon: Option<Icon>

Optional leading icon for command recognition. Icons are visual reinforcement only; label remains the accessible name.

checked: Option<bool>

Some reserves the leading selection gutter and publishes a semantic checked state. None is an ordinary command row.

destructive: bool

Destructive rows are styled as danger actions and are never the implicit keyboard target when a menu opens.

enabled: bool

Disabled rows remain visible and announced but cannot be invoked.

shortcut: Option<Shortcut>

The keyboard shortcut that runs the same command, shown at the row’s trailing edge in the platform’s spelling.

submenu: Option<Vec<MenuItem>>

Some makes the row open a nested menu (with a chevron) instead of running action.

Separator

Implementations

impl MenuItem

pub fn action<F>(label: impl Into<String>, action: F) -> MenuItem

where F: Fn() + 'static,

pub fn icon_action<F>( icon: Icon, label: impl Into<String>, action: F, ) -> MenuItem

where F: Fn() + 'static,

A command row with a themed leading icon. Menus containing icon rows reserve the same gutter for every command so labels stay aligned.

pub fn selection(label: impl Into<String>) -> MenuItem

pub fn destructive_action<F>(label: impl Into<String>, action: F) -> MenuItem

where F: Fn() + 'static,

pub fn destructive_selection(label: impl Into<String>) -> MenuItem

pub fn submenu(label: impl Into<String>, items: Vec<MenuItem>) -> MenuItem

A row that opens a nested menu of items beside it: on hover, a click, Enter or the arrow towards it. Its chevron says so.

pub fn with_icon(self, icon: Icon) -> MenuItem

pub fn with_shortcut(self, shortcut: impl Into<Shortcut>) -> MenuItem

Show the keyboard shortcut that runs the same command at the row’s trailing edge (Shortcut::command("S"), Shortcut::key("Delete")).

pub fn with_enabled(self, enabled: bool) -> MenuItem

Set whether this command can currently be invoked.

pub fn with_checked(self, checked: bool) -> MenuItem

Make this a state row (“Copy on select”, a sort order): a check mark when checked, and a semantic checked state either way. Checked and unchecked peers share the same leading gutter, so labels never jump as state changes.

pub fn separator() -> MenuItem

pub fn label(&self) -> Option<&str>

pub fn checked(&self) -> Option<bool>

Semantic checked state for choice/toggle rows. None means this is a regular command, rather than an unchecked choice.

pub fn shortcut(&self) -> Option<&Shortcut>

The shortcut shown on the row, if any.

pub fn submenu_items(&self) -> Option<&[MenuItem]>

The nested menu’s rows, for a row that opens one.

pub fn is_enabled(&self) -> bool

Trait Implementations

impl Clone for MenuItem

fn clone(&self) -> MenuItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MenuItem

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

Formats the value using the given formatter.