Struct ContextMenu 

pub struct ContextMenu<Msg> { /* private fields */ }

Wraps an area and opens a menu of ContextItems at the pointer on a right click, or next to the focused widget on Shift+F10 or the menu key.

The menu is a layer on the overlay surface that unfolds over motion.enter. Hovered and highlighted rows show the pillar and slide their label one cell while shortcuts stay at the right edge. ↑/↓ move (skipping gaps and disabled rows), Home/End jump, typing a letter jumps to the next row starting with it, → or Enter opens a submenu, ← or Esc closes it, Enter or Space chooses. Choosing sends the item’s message. A press anywhere outside the menu closes it and still reaches what it landed on; a right click inside the area reopens it there.

Style keys: see ContextItem.

use qframe::prelude::*;
use qframe::widgets::{ContextMenu, ContextItem};

struct Files { deleted: bool }

#[derive(Clone)]
enum Msg { Delete }

impl App for Files {
    type Msg = Msg;
    fn update(&mut self, Msg::Delete: Msg) -> Command<Msg> {
        self.deleted = true;
        Command::none()
    }
    fn view(&self, ui: &mut View<'_, Msg>) {
        let items = [ContextItem::new("Delete", Msg::Delete).danger(true)];
        ui.add_with(ContextMenu::new(items), |ui| {
            ui.add(Text::new("report.pdf"));
        });
    }
}

let mut app = Harness::new(Files { deleted: false }, 30, 5);
app.set_reduced_motion(true);
app.mouse(qframe::event::MouseKind::Down(qframe::event::MouseButton::Right), 2, 0);
app.press("down").press("enter");
assert!(app.app().deleted);

Implementations

impl<Msg: Clone + 'static> ContextMenu<Msg>

pub fn new(items: impl IntoIterator<Item = ContextItem<Msg>>) -> Self

A context menu of items over the widgets added with View::add_with.

Trait Implementations

impl<Msg: Clone + 'static> Container<Msg> for ContextMenu<Msg>

fn set_children(&mut self, children: Vec<Node<Msg>>)

Receives the children built for this widget.

impl<Msg: Clone + 'static> Widget<Msg> for ContextMenu<Msg>

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

The size the widget wants when it may use up to available.

fn paint(&self, cx: &mut PaintCx<'_>, area: Rect)

Draws the widget into area.

fn paint_overlay(&self, cx: &mut PaintCx<'_>, _area: Rect)

Draws the widget’s overlay after the whole view was painted, when it asked for one with PaintCx::request_overlay. anchor is the area the widget was painted in.

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

Handles input. Returns true when the event was used; unused key and scroll events bubble to the parent widget.

fn children(&self) -> &[Node<Msg>]

Child nodes, for widgets that contain other widgets.

fn children_mut(&mut self) -> &mut [Node<Msg>]

Mutable child nodes, used to assign ids.

fn focusable(&self) -> bool

Whether the widget can take keyboard focus.