pub struct Menu {
pub handle: ControlHandle,
}Expand description
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: ControlHandleImplementations§
Source§impl Menu
impl Menu
Sourcepub fn builder<'a>() -> MenuBuilder<'a>
pub fn builder<'a>() -> MenuBuilder<'a>
Examples found in repository?
60 fn build_ui(mut data: SystemTray) -> Result<SystemTrayUi, nwg::NwgError> {
61 use nwg::Event as E;
62
63 // Resources
64 nwg::Icon::builder()
65 .source_file(Some("./test_rc/cog.ico"))
66 .build(&mut data.icon)?;
67
68 // Controls
69 nwg::MessageWindow::builder()
70 .build(&mut data.window)?;
71
72 nwg::TrayNotification::builder()
73 .parent(&data.window)
74 .icon(Some(&data.icon))
75 .tip(Some("Hello"))
76 .build(&mut data.tray)?;
77
78 nwg::Menu::builder()
79 .popup(true)
80 .parent(&data.window)
81 .build(&mut data.tray_menu)?;
82
83 nwg::MenuItem::builder()
84 .text("Hello")
85 .parent(&data.tray_menu)
86 .build(&mut data.tray_item1)?;
87
88 nwg::MenuItem::builder()
89 .text("Popup")
90 .parent(&data.tray_menu)
91 .build(&mut data.tray_item2)?;
92
93 nwg::MenuItem::builder()
94 .text("Exit")
95 .parent(&data.tray_menu)
96 .build(&mut data.tray_item3)?;
97
98 // Wrap-up
99 let ui = SystemTrayUi {
100 inner: Rc::new(data),
101 default_handler: Default::default(),
102 };
103
104 // Events
105 let evt_ui = Rc::downgrade(&ui.inner);
106 let handle_events = move |evt, _evt_data, handle| {
107 if let Some(evt_ui) = evt_ui.upgrade() {
108 match evt {
109 E::OnContextMenu =>
110 if &handle == &evt_ui.tray {
111 SystemTray::show_menu(&evt_ui);
112 }
113 E::OnMenuItemSelected =>
114 if &handle == &evt_ui.tray_item1 {
115 SystemTray::hello1(&evt_ui);
116 } else if &handle == &evt_ui.tray_item2 {
117 SystemTray::hello2(&evt_ui);
118 } else if &handle == &evt_ui.tray_item3 {
119 SystemTray::exit(&evt_ui);
120 },
121 _ => {}
122 }
123 }
124 };
125
126 ui.default_handler.borrow_mut().push(
127 nwg::full_bind_event_handler(&ui.window.handle, handle_events)
128 );
129
130 return Ok(ui);
131 }Sourcepub fn enabled(&self) -> bool
pub fn enabled(&self) -> bool
Return true if the control user can interact with the control, return false otherwise
Sourcepub fn set_enabled(&self, v: bool)
pub fn set_enabled(&self, v: bool)
Enable or disable the control A popup menu cannot be disabled
Sourcepub fn popup_with_flags(&self, x: i32, y: i32, flags: PopupMenuFlags)
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.