Struct MenuBar 

pub struct MenuBar { /* private fields */ }

A classic Win 3.1 menu bar.

MenuBar::new takes the bounding rect for the bar itself. The bar paints in the normal pass; any open drop-down is rendered in the overlay pass so it floats over every sibling widget.

Labels may include an & immediately before a character to declare a mnemonic: &File displays “File” with F underlined and binds Alt+F (top-level) or just F (when the menu is already open) to that entry. Escape closes the open menu.

Implementations

impl MenuBar

pub fn new(rect: Rect) -> Self

pub fn add_menu(self, menu: Menu) -> Self

pub fn push_menu(&mut self, menu: Menu)

pub fn open(&mut self, index: usize)

Programmatically open the menu at index — useful for tests and for hooking up custom keyboard shortcuts at the application level.

Trait Implementations

impl Widget for MenuBar

fn bounds(&self) -> Rect

Logical bounds relative to the window root, in saudade pixels.

fn paint(&mut self, painter: &mut Painter<'_>, theme: &Theme)

Render the widget in the normal pass.

fn paint_overlay(&mut self, painter: &mut Painter<'_>, theme: &Theme)

Render anything that needs to float on top of every sibling — open menu popups, tooltips, drag previews. Runs after every widget’s regular paint is finished. Default: no-op.

fn event(&mut self, event: &Event, ctx: &mut EventCtx)

Handle a typed input event. Default: ignore.

fn captures_pointer(&self) -> bool

Internal hook for capture-on-press dispatch. Default: never captured. Implementations like Button override this so pointer events keep flowing to them while a press is in progress, even if the cursor leaves the widget’s bounds.

fn accepts_accelerators(&self) -> bool

true if this widget should receive every keyboard event regardless of focus. Used by menu bars so that Alt+letter accelerators reach them even while a sibling (e.g., a text editor) holds focus.

fn layout(&mut self, bounds: Rect)

Position the widget inside the rectangle the parent has allocated.

fn popup_request(&self) -> Option<PopupRequest>

Ask the runtime to host a popup window for this widget. Returning Some makes the runtime open (or move) a borderless top-level window at the indicated logical-coord rect so the popup can extend past the main window’s edges. Container widgets propagate this from their children. Default: no popup.

fn focusable(&self) -> bool

true if this widget accepts keyboard focus. The parent container remembers the last focusable widget the user clicked, and routes keyboard events only there.

fn set_focused(&mut self, _focused: bool)

Inform the widget that it has gained or lost keyboard focus. Default: ignore. Editing widgets override this to show/hide their cursor or to commit pending input.

fn focus_first(&mut self) -> bool

Try to give keyboard focus to this widget or one of its descendants. Returns true if a focusable target was located and now holds focus.

fn wants_ticks(&self) -> bool

true if this widget needs periodic Event::Tick events to drive an animation. The runtime polls this after every dispatch and, while any widget in the tree wants ticks, fires Tick at roughly 60 Hz. Container widgets propagate from children. Default: no animation.