Struct Menu 

pub struct Menu { /* private fields */ }

A vertical list of buttons, one per entry, as a popup menu shows them.

A click on an entry calls on_activate with its id, then closes the popups it is in. A click on an entry with a submenu calls on_open_submenu and opens the submenu as a popup next to it, with the same styles and handlers. Disabled entries ignore clicks. Each style takes a value or a closure.

use crabshell_ui::{Menu, MenuEntry, PopupWindow};

let quit = MenuEntry {
    id: 1,
    label: "Quit".into(),
    separator: false,
    enabled: true,
    toggle: None,
    checked: false,
    submenu: false,
    children: Vec::new(),
};
let popup = PopupWindow::new().child(
    Menu::new(vec![quit]).on_activate(|_cx, id| println!("clicked {id}")),
);

Implementations

impl Menu

pub fn new(entries: impl IntoProp<Vec<MenuEntry>>) -> Menu

A menu of entries: a list, or a closure that returns one.

pub fn style(self, style: impl IntoProp<Style>) -> Menu

Sets the style of the menu’s box: its background, border and padding.

pub fn item_style(self, style: impl IntoProp<Style>) -> Menu

Sets each entry’s style. The default pads the text 4 px above and below and 12 px left and right.

pub fn hover_style(self, style: impl IntoProp<Style>) -> Menu

Sets the style laid over an entry under the pointer. The default is a faint gray background.

pub fn separator_style(self, style: impl IntoProp<Style>) -> Menu

Sets a separator’s style. A separator is as tall as the style’s vertical padding twice; the default is a 2 px gray line.

pub fn on_activate(self, handler: impl Fn(&Cx, i32) + 'static) -> Menu

Runs handler with an entry’s id when that entry is clicked.

pub fn on_open_submenu(self, handler: impl Fn(&Cx, i32) + 'static) -> Menu

Runs handler with an entry’s id when its submenu opens, as a tray menu tells its app with open_submenu.

Trait Implementations

impl Widget for Menu

fn into_element(self: Box<Self>) -> Element

Turns the description, and everything inside it, into the element the window builds nodes from. It runs when the window is created or a list item first appears, before the window’s tree is touched and without recording what it reads, so it only describes.