Struct druid::HotKey

pub struct HotKey { /* fields omitted */ }

A description of a keyboard shortcut.

This type is only intended to be used to describe shortcuts, and recognize them when they arrive.

Examples

SysMods matches the Command key on macOS and Ctrl elsewhere:

use druid_shell::{HotKey, KbKey, KeyEvent, RawMods, SysMods};

let hotkey = HotKey::new(SysMods::Cmd, "a");

#[cfg(target_os = "macos")]
assert!(hotkey.matches(KeyEvent::for_test(RawMods::Meta, "a")));

#[cfg(target_os = "windows")]
assert!(hotkey.matches(KeyEvent::for_test(RawMods::Ctrl, "a")));

None matches only the key without modifiers:

use druid_shell::{HotKey, KbKey, KeyEvent, RawMods, SysMods};

let hotkey = HotKey::new(None, KbKey::ArrowLeft);

assert!(hotkey.matches(KeyEvent::for_test(RawMods::None, KbKey::ArrowLeft)));
assert!(!hotkey.matches(KeyEvent::for_test(RawMods::Ctrl, KbKey::ArrowLeft)));

Implementations

impl HotKey

pub fn new(mods: impl Into<Option<RawMods>>, key: impl IntoKey) -> HotKey

Create a new hotkey.

The first argument describes the keyboard modifiers. This can be None, or an instance of either SysMods, or RawMods. SysMods unify the 'Command' key on macOS with the 'Ctrl' key on other platforms.

The second argument describes the non-modifier key. This can be either a &str or a KbKey; the former is merely a convenient shorthand for KbKey::Character().

Examples

use druid_shell::{HotKey, KbKey, RawMods, SysMods};

let select_all = HotKey::new(SysMods::Cmd, "a");
let esc = HotKey::new(None, KbKey::Escape);
let macos_fullscreen = HotKey::new(RawMods::CtrlMeta, "f");

pub fn matches(&self, event: impl Borrow<KeyEvent>) -> bool

Returns true if this KeyEvent matches this HotKey.

Trait Implementations

impl Clone for HotKey

pub fn clone(&self) -> HotKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for HotKey

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

Formats the value using the given formatter.