Struct native_windows_gui::Menu

pub struct Menu {
    pub handle: ControlHandle,
}

A windows menu. Can represent a menu in a window menubar, a context menu, or a submenu in another menu

Requires the menu feature.

Builder parameters:

• text: The text of the menu
• disabled: If the menu can be selected by the user
• popup: The menu is a context menu
• parent: A top level window, a menu or None. With a top level window, the menu is added to the menu bar if popup is set to false.

Control events:

• OnMenuOpen: Sent when a drop-down menu or submenu is about to become active.
• OnMenuHover: When the user hovers the menu
• OnMenuEnter: When the user enters the menu. Technically, when the user enters the menu modal loop.
• OnMenuExit: When the menu is closed. Technically, when the user exits the menu modal loop.

Menu Access Keys

Menu can have access keys. An access key is an underlined letter in the text of a menu item. When a menu is active, the user can select a menu item by pressing the key that corresponds to the item’s underlined letter. The user makes the menu bar active by pressing the ALT key to highlight the first item on the menu bar. A menu is active when it is displayed.

To create an access key for a menu item, precede any character in the item’s text string with an ampersand. For example, the text string “&Move” causes the system to underline the letter “M”.

use native_windows_gui as nwg;

fn menu(menu: &mut nwg::Menu, window: &nwg::Window) -> Result<(), nwg::NwgError> {
    nwg::Menu::builder()
        .text("&Hello")
        .disabled(false)
        .parent(window)
        .build(menu)
}

Fields

handle: ControlHandle

Implementations

impl Menu

pub fn builder<'a>() -> MenuBuilder<'a>

pub fn enabled(&self) -> bool

Return true if the control user can interact with the control, return false otherwise

pub fn set_enabled(&self, v: bool)

Enable or disable the control A popup menu cannot be disabled

pub fn popup_with_flags(&self, x: i32, y: i32, flags: PopupMenuFlags)

Show a popup menu as the selected position. Do nothing for menubar menu.

pub fn popup(&self, x: i32, y: i32)

Show a popup menu as the selected position. Do nothing for menubar menu.

Trait Implementations

impl Default for Menu

fn default() -> Menu

Returns the “default value” for a type.

impl Drop for Menu

fn drop(&mut self)

Executes the destructor for this type.

impl From<&Menu> for ControlHandle

fn from(control: &Menu) -> Self

Converts to this type from the input type.

impl From<&mut Menu> for ControlHandle

fn from(control: &mut Menu) -> Self

Converts to this type from the input type.

impl PartialEq<ControlHandle> for Menu

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Menu> for ControlHandle

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Menu> for Menu

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Menu

impl StructuralEq for Menu

impl StructuralPartialEq for Menu