Struct MaterialMenu 

pub struct MaterialMenu { /* private fields */ }

An M3 menu surface. Use MenuPopup to open it from a trigger.

Implementations

impl MaterialMenu

pub fn new(id: impl Into<ElementId>) -> Self

pub fn style(self, style: MenuStyle) -> Self

pub fn density(self, density: MenuDensity) -> Self

Item density: the kit’s baseline densities, and half those steps for Expressive items.

pub fn item(self, item: MaterialMenuItem) -> Self

Append an item to the last group.

pub fn items(self, items: impl IntoIterator<Item = MaterialMenuItem>) -> Self

pub fn group(self, group: MenuGroup) -> Self

pub fn width(self, width: f32) -> Self

Width in design px (default 200 baseline, 208 Expressive).

pub fn elevated(self, elevated: bool) -> Self

Paint the menu’s level 2 shadow (default). A popup paints it on its revealing frame instead.

pub fn track_focus(self, focus: &FocusHandle) -> Self

The handle the menu root tracks; arrow keys from it reach the items.

pub fn on_dismiss( self, handler: impl Fn(&mut Window, &mut App) + 'static, ) -> Self

Escape inside the menu.

pub fn on_activate( self, handler: impl Fn(&mut Window, &mut App) + 'static, ) -> Self

Runs after any enabled item (other than a sub-menu) is activated.

pub fn on_collapse( self, handler: impl Fn(&mut Window, &mut App) + 'static, ) -> Self

Left inside the menu, e.g. to close it as a cascading sub-menu.

pub fn natural_height(&self) -> f32

The menu’s natural height in design px.

pub fn item_bottom(&self, index: usize) -> Option<f32>

The bottom of the item at flat index (its row without a divider below it), in design px from the menu’s top.

pub fn item_top(&self, index: usize) -> Option<f32>

The top of the item at flat index (its row, with an Expressive row’s insets), in design px from the menu’s top.

Trait Implementations

impl IntoElement for MaterialMenu

type Element = ViewElement<MaterialMenu>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements [Element].

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed [AnyElement].

impl RenderOnce for MaterialMenu

fn render(self, window: &mut Window, cx: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to [Render::render()] method which takes a mutable reference.