Struct KeyCombo 

pub struct KeyCombo {
    pub key: ComboKey,
    pub modifiers: Modifiers,
}

A key plus the exact modifier state required to trigger it.

Build one with KeyCombo::new or the platform-flavored shorthands KeyCombo::command, KeyCombo::alt, KeyCombo::bare.

Fields

key: ComboKey

The key that must be pressed.

modifiers: Modifiers

The modifiers that must be held, compared by exact equality.

Implementations

impl KeyCombo

pub fn new(key: ComboKey, modifiers: Modifiers) -> Self

Builds a combo from an explicit key and modifier state.

pub fn command(c: char) -> Self

Builds a combo for c held with the platform “command” modifier (Cmd on macOS, Ctrl elsewhere).

pub fn alt(c: char) -> Self

Builds a combo for c held with Alt.

pub fn bare(key: ComboKey) -> Self

Builds a combo for key with no modifiers held.

pub fn matches( &self, key: &Key, physical: Physical, modifiers: Modifiers, ) -> bool

Reports whether a key press satisfies this combo.

Modifiers are compared by exact equality, not Modifiers::contains: a combo for Cmd+A does not match a Cmd+Shift+A press. This differs from the pointer modifier fields on Keymap, which the widget tests with contains semantics.

ComboKey::Char resolves the physical key to its latin equivalent via Key::to_latin so the shortcut fires regardless of keyboard layout (e.g. a Dvorak or Cyrillic layout), then compares case-insensitively. When to_latin cannot resolve a latin character (the key has no established Latin-alphabet code, e.g. punctuation outside the mapped set), this falls back to comparing the logical Key::Character text case-insensitively.

Trait Implementations

impl Clone for KeyCombo

fn clone(&self) -> KeyCombo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for KeyCombo

impl Debug for KeyCombo

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

Formats the value using the given formatter.

impl Eq for KeyCombo

impl PartialEq for KeyCombo

fn eq(&self, other: &KeyCombo) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for KeyCombo