Struct ShortcutManager 

pub struct ShortcutManager<C> { /* private fields */ }

Scans egui key events each frame and returns triggered commands.

Lookup order: extra scope → scoped stack (top → bottom) → global. Non-consuming scopes continue propagation; consuming scopes stop lower scopes and the global map. Within one scope/map, the most specific logical shortcut wins.

Implementations

impl<C: Clone> ShortcutManager<C>

pub fn new(global: Arc<RwLock<ShortcutMap<C>>>) -> Self

pub fn push_scope(&mut self, scope: ShortcutScope<C>)

Pushes a new scope onto the stack. Scopes are checked top-to-bottom during dispatch.

pub fn pop_scope(&mut self)

Removes the top scope from the stack.

pub fn register_global(&mut self, sc: Shortcut, cmd: C)

Inserts or replaces a shortcut in the shared global map.

pub fn dispatch(&self, ctx: &Context) -> Vec<CommandTriggered>

where C: Into<CommandId>,

Scan egui key events and return all triggered commands this frame.

Matched key events are consumed from the egui input queue so that egui widgets don’t double-handle them.

Returns an empty Vec when Context::wants_keyboard_input is true (i.e. a text-edit widget has focus) so that typing never fires shortcuts.

pub fn dispatch_raw_with_extra( &self, ctx: &Context, extra: Option<&ShortcutMap<C>>, ) -> Vec<C>

Dispatch with an optional extra scope checked before global shortcuts.

Use this when a context-specific shortcut map (e.g. editor scope) should take priority without needing push_scope/pop_scope on a mutable static. The extra scope is always consuming: a match there skips the global map.

Returns an empty Vec when Context::wants_keyboard_input is true.

pub fn dispatch_raw(&self, ctx: &Context) -> Vec<C>

Dispatch without converting to CommandTriggered — returns raw C values.

Returns an empty Vec when Context::wants_keyboard_input is true.