Module menu 

Menu widgets, properties and other types.

use zng::prelude::*;

fn main_menu() -> UiNode {
    Menu!(ui_vec![
        SubMenu!(
            "File",
            ui_vec![
                Button!(zng::app::NEW_CMD.scoped(WINDOW.id())),
                Button!(zng::app::OPEN_CMD.scoped(WINDOW.id())),
                Toggle! {
                    child = Text!("Auto Save");
                    checked = var(true);
                },
                Hr!(),
                SubMenu!(
                    "Recent",
                    (0..10).map(|i| Button! {
                        child = Text!(formatx!("recent file {i}"));
                    })
                ),
                Hr!(),
                Button!(zng::app::EXIT_CMD),
            ]
        ),
        SubMenu!(
            "Help",
            ui_vec![Button! {
                child = Text!("About");
                on_click = hn!(|_| {});
            }]
        ),
    ])
}

Window! {
    child_top = main_menu();
    zng::app::on_new = hn!(|_| {});
    zng::app::on_open = hn!(|_| {});
    // ..
}

The example above declares a Menu! for a window, it demonstrates nested SubMenu!, and menu items, Button!, Toggle! and Hr!. There is no menu item widget, the SubMenu! widget re-styles button and toggle.

Context Menu

This module also provides a context menu. The example below declares a context menu for the window, it will show on context click, that is, by right-clicking the window, long pressing it or pressing the context menu key.

use zng::prelude::*;

Window! {
    context_menu = ContextMenu!(ui_vec![
        Button!(zng::app::NEW_CMD.scoped(WINDOW.id())),
        Button!(zng::app::OPEN_CMD.scoped(WINDOW.id())),
        Toggle! {
            child = Text!("Auto Save");
            checked = var(true);
        },
        Hr!(),
        SubMenu!(
            "Help",
            ui_vec![Button! {
                child = Text!("About");
                on_click = hn!(|_| {});
            }]
        ),
        Hr!(),
        Button!(zng::app::EXIT_CMD),
    ]);
}

Full API

See zng_wgt_menu for the full widget API.

Modules

context

Context menu widget and properties.

popup

Sub-menu popup widget and properties.

sub

Submenu widget and properties.

Structs

ButtonStyle

W Style applied to all Button! widgets inside Menu! root.

DefaultStyle

W Default Menu! style.

IconButtonStyle

W Alternate style for buttons inside a menu.

Menu

W Menu root panel.

TextInputStyle

W Style applied to all TextInput! widgets inside Menu! root.

ToggleStyle

W Style applied to all Toggle! widgets inside Menu! root.

Functions

icon

P Menu item icon.

icon_fn

P Menu item icon from widget function.

panel_fn

P Widget function that generates the menu layout.

shortcut_txt

P Menu item shortcut text.

style_fn

P Extends or replaces the widget style.