Enum Key

pub enum Key<Str = SmolStr> {
    Named(NamedKey),
    Character(Str),
    Unidentified(NativeKey),
    Dead(Option<char>),
}

Key represents the meaning of a keypress.

This is a superset of the UI Events Specification’s KeyboardEvent.key with additions:

• All simple variants are wrapped under the Named variant
• The Unidentified variant here, can still identify a key through it’s NativeKeyCode.
• The Dead variant here, can specify the character which is inserted when pressing the dead-key twice.

Variants

Named(NamedKey)

A simple (unparameterised) action

Character(Str)

A key string that corresponds to the character typed by the user, taking into account the user’s current locale setting, and any system-level keyboard mapping overrides that are in effect.

Unidentified(NativeKey)

This variant is used when the key cannot be translated to any other variant.

The native key is provided (if available) in order to allow the user to specify keybindings for keys which are not defined by this API, mainly through some sort of UI.

Dead(Option<char>)

Contains the text representation of the dead-key when available.

Platform-specific

• Web: Always contains None

Implementations

impl Key

pub fn as_ref(&self) -> Key<&str>

Convert Key::Character(SmolStr) to Key::Character(&str) so you can more easily match on Key. All other variants remain unchanged.

impl Key

pub fn to_text(&self) -> Option<&str>

Convert a key to its approximate textual equivalent.

Examples

use winit::keyboard::{Key, NamedKey};

assert_eq!(Key::Character("a".into()).to_text(), Some("a"));
assert_eq!(Key::Named(NamedKey::Enter).to_text(), Some("\r"));
assert_eq!(Key::Named(NamedKey::F20).to_text(), None);

Trait Implementations

impl<Str> Clone for Key<Str>

where Str: Clone,

fn clone(&self) -> Key<Str>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Str> Debug for Key<Str>

where Str: Debug,

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

Formats the value using the given formatter.

impl From<NamedKey> for Key

fn from(action: NamedKey) -> Key

Converts to this type from the input type.

impl From<NativeKey> for Key

fn from(code: NativeKey) -> Key

Converts to this type from the input type.

impl<Str> Hash for Key<Str>

where Str: Hash,

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<Str> Ord for Key<Str>

where Str: Ord,

fn cmp(&self, other: &Key<Str>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<Str> PartialEq<&str> for Key<Str>

where Str: PartialEq<str>,

fn eq(&self, rhs: &&str) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<Str> PartialEq<Key<Str>> for NativeKey

fn eq(&self, rhs: &Key<Str>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<Str> PartialEq<NamedKey> for Key<Str>

fn eq(&self, rhs: &NamedKey) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<Str> PartialEq<NativeKey> for Key<Str>

fn eq(&self, rhs: &NativeKey) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<Str> PartialEq<str> for Key<Str>

where Str: PartialEq<str>,

fn eq(&self, rhs: &str) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<Str> PartialEq for Key<Str>

where Str: PartialEq,

fn eq(&self, other: &Key<Str>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<Str> PartialOrd for Key<Str>

where Str: PartialOrd,

fn partial_cmp(&self, other: &Key<Str>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<Str> Eq for Key<Str>

where Str: Eq,

impl<Str> StructuralPartialEq for Key<Str>