Struct MenuBar 

pub struct MenuBar { /* private fields */ }

A row of menu titles: a press on one opens its Menu below it, and while one is open the pointer coming over another title switches to it. Left and Right switch menus from the keyboard. The bar is not in the Tab order: give it the keyboard with MenuBar::activate (on F10, say).

Implementations

impl MenuBar

pub fn new() -> Self

A bar without menus.

pub fn with_menu( self, title: impl Into<String>, items: impl IntoIterator<Item = MenuItem>, ) -> Self

The bar with a menu titled title of items after the others.

pub fn style() -> Style

The style for a bar across the top of a window.

pub fn activate(&mut self, cx: &mut EventCx<'_>)

Gives the bar the keyboard, its first title highlighted: Left and Right move, Down, Enter or Space open, Escape lets go.

pub fn set_items( &mut self, index: usize, items: impl IntoIterator<Item = MenuItem>, ) -> bool

Replaces the entries of menu number index (a check mark that follows a setting); shown from the next time the menu opens. false if there is no such menu.

pub fn open_menu(&self) -> Option<usize>

The title of the menu open, by index.

Trait Implementations

impl Debug for MenuBar

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MenuBar

fn default() -> Self

Returns the “default value” for a type.

impl Widget for MenuBar

fn measure(&mut self, cx: &mut LayoutCx<'_>, _: Constraints) -> Size

The size the widget wants within constraints, for a widget without children (one with children is sized by its style and its children). Physical pixels.

fn paint(&mut self, cx: &PaintCx<'_>, canvas: &mut Canvas<'_>)

Paints the widget below its children.

fn event(&mut self, cx: &mut EventCx<'_>, event: &Event<'_>) -> Handled

Handles event. An event the widget does not handle goes on to its parent.

fn accessibility(&self, cx: &PaintCx<'_>, node: &mut AccessNode)

Describes the widget to assistive technology: fills node, which starts as a Role::Group with the widget’s rectangle. Called only while assistive technology is listening; it may allocate.

fn access_action( &mut self, cx: &mut EventCx<'_>, request: &AccessRequest<'_>, ) -> Handled

Does what assistive technology asks (only actions the widget’s node lists are asked of it). Focus and scrolling into view are done for every widget; a request the widget does not handle goes on to its parent if it is a scroll.

fn layout(&mut self, cx: &mut LayoutCx<'_>, size: Size)

Layout decided the widget’s size: re-wrap text or recompute anything that depends on it. Called after every layout pass that changed the size.

fn paint_over(&mut self, cx: &PaintCx<'_>, canvas: &mut Canvas<'_>)

Paints the widget over its children: scroll bars, focus rings, overlays.

fn accepts_focus(&self) -> bool

Whether the widget takes keyboard focus, by click or by Tab.

fn focus_on_press(&self) -> bool

Whether a press on the widget, or on a widget inside it that takes no focus, focuses it (if it accepts focus). A container reachable by Tab, such as a dock’s tab list, says no, so clicks on its contents do not focus it; it can still ask for focus itself.