Enum NativeMenuNode 

pub enum NativeMenuNode {
    Item {
        id: MenuItemId,
        title: String,
        key_equiv: Option<NativeKeyEquivalent>,
        enabled: bool,
        check: NativeCheck,
    },
    Submenu {
        title: String,
        children: Vec<NativeMenuNode>,
    },
    Separator,
    Standard {
        role: StandardMenuRole,
        labels: StandardLabels,
        quit_item: Option<StandardRoutedItem>,
        settings_item: Option<StandardRoutedItem>,
    },
}

One node of a native menu tree.

Variants

Item

A leaf command.

Fields

id: MenuItemId

Correlates the native item back to the logical one on activation.

title: String

Display text (mnemonics already stripped, locale already resolved).

key_equiv: Option<NativeKeyEquivalent>

Key equivalent, if any.

enabled: bool

Whether the item is enabled.

check: NativeCheck

Check-mark state.

Submenu

A submenu with its own children.

Fields

title: String

Submenu title.

children: Vec<NativeMenuNode>

Child nodes.

Separator

A separator line.

Standard

A platform-standard menu the backend fills in, with localized chrome.

Fields

role: StandardMenuRole

Which standard menu.

labels: StandardLabels

Localized display strings (supplied by the widget layer).

quit_item: Option<StandardRoutedItem>

App menu only: route Quit back to the app under this item instead of firing the platform’s own terminate selector.

None — the default — keeps the system behaviour: on macOS the item is bound to terminate:, which works with no app wiring at all and is why ⌘Q is live even for an app that declares no menus.

Some(..) builds Quit as an ordinary routed item — same id → the activation recorded for it, and the key equivalent the widget layer resolved. An app with anything to lose on exit must set this: a main-menu key equivalent is dispatched by the platform before the responder chain, and terminate: does not run winit’s exit path, so an in-app quit shortcut is shadowed rather than merely duplicated. Whatever the app routes to then owes the exit itself — nothing here terminates.

settings_item: Option<StandardRoutedItem>

App menu only: build a Settings… item under this id, placed where the platform expects it (on macOS: after About, with the ⌘, key equivalent).

Unlike Quit there is no None fallback that still does something — no platform ships a default action for opening an app’s settings — so None simply omits the item. An app that has a settings window routes it; one that has none leaves the slot empty rather than showing a row that does nothing.

Trait Implementations

impl Clone for NativeMenuNode

fn clone(&self) -> NativeMenuNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NativeMenuNode

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

Formats the value using the given formatter.