Struct NativeMenu 

pub struct NativeMenu { /* private fields */ }

A menu rendered by the operating system.

Build it with the NativeMenu::menu / NativeMenu::separator builders, then call NativeMenu::show to display it at a position.

Implementations

impl NativeMenu

pub fn new() -> Self

Create an empty native menu.

pub fn menu( self, label: impl Into<SharedString>, action: Box<dyn Action>, ) -> Self

Append a clickable item that dispatches action when selected.

pub fn menu_with_disabled( self, label: impl Into<SharedString>, disabled: bool, action: Box<dyn Action>, ) -> Self

Append an item, controlling its disabled state.

pub fn menu_with_check( self, label: impl Into<SharedString>, checked: bool, action: Box<dyn Action>, ) -> Self

Append an item, controlling its checked state (a check mark is shown).

pub fn separator(self) -> Self

Append a separator line.

pub fn submenu( self, label: impl Into<SharedString>, submenu: NativeMenu, ) -> Self

Append a submenu built from another NativeMenu.

pub fn is_empty(&self) -> bool

Whether the menu has no items.

pub fn show(self, position: Point<Pixels>, window: &mut Window, cx: &mut App)

Pop up the menu at position (window coordinates, in logical pixels).

The menu is shown without blocking the caller: the OS tracking loop runs off GPUI’s call stack, so GPUI is not borrowed while it is open. When an item is selected, its action is dispatched via Window::dispatch_action.

Trait Implementations

impl Default for NativeMenu

fn default() -> NativeMenu

Returns the “default value” for a type.

impl From<Menu> for NativeMenu

Reuse an existing GPUI menu definition as a native menu.

Actions, separators, submenus, checked, and disabled are mapped over; system menus (e.g. macOS Services) have no native popup equivalent and are skipped.

fn from(menu: Menu) -> Self

Converts to this type from the input type.