[−][src]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[src]

pub fn builder<'a>() -> MenuBuilder<'a>[src]

pub fn enabled(&self) -> bool[src]

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

pub fn set_enabled(&self, v: bool)[src]

Enable or disable the control A popup menu cannot be disabled

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

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

Trait Implementations

impl Default for Menu[src]

impl Eq for Menu[src]

impl<'_> From<&'_ Menu> for ControlHandle[src]

impl PartialEq<ControlHandle> for Menu[src]

impl PartialEq<Menu> for Menu[src]

impl PartialEq<Menu> for ControlHandle[src]

impl StructuralEq for Menu[src]

impl StructuralPartialEq for Menu[src]

Auto Trait Implementations

impl RefUnwindSafe for Menu

impl !Send for Menu

impl !Sync for Menu

impl Unpin for Menu

impl UnwindSafe for Menu

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized, [src]

impl<T> Borrow<T> for T where
    T: ?Sized, [src]

impl<T> BorrowMut<T> for T where
    T: ?Sized, [src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, [src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, [src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, [src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.