Struct druid::HotKey

pub struct HotKey { /* private fields */ }

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

fn clone(&self) -> HotKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for HotKey

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

Formats the value using the given formatter.

impl PartialEq<HotKey> for HotKey

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for HotKey

impl StructuralEq for HotKey

impl StructuralPartialEq for HotKey