Enum KeyCode

#[non_exhaustive]
#[repr(u16)]
pub enum KeyCode {
    Unidentified(NativeKeyCode),
    Backquote = 1,
    Backslash,
    BracketLeft,
    BracketRight,
    Comma,
    Digit0,
    Digit1,
    Digit2,
    Digit3,
    Digit4,
    Digit5,
    Digit6,
    Digit7,
    Digit8,
    Digit9,
    Equal,
    IntlBackslash,
    IntlRo,
    IntlYen,
    KeyA,
    KeyB,
    KeyC,
    KeyD,
    KeyE,
    KeyF,
    KeyG,
    KeyH,
    KeyI,
    KeyJ,
    KeyK,
    KeyL,
    KeyM,
    KeyN,
    KeyO,
    KeyP,
    KeyQ,
    KeyR,
    KeyS,
    KeyT,
    KeyU,
    KeyV,
    KeyW,
    KeyX,
    KeyY,
    KeyZ,
    Minus,
    Period,
    Quote,
    Semicolon,
    Slash,
    AltLeft,
    AltRight,
    Backspace,
    CapsLock,
    ContextMenu,
    CtrlLeft,
    CtrlRight,
    Enter,
    SuperLeft,
    SuperRight,
    ShiftLeft,
    ShiftRight,
    Space,
    Tab,
    Convert,
    KanaMode,
    Lang1,
    Lang2,
    Lang3,
    Lang4,
    Lang5,
    NonConvert,
    Delete,
    End,
    Help,
    Home,
    Insert,
    PageDown,
    PageUp,
    ArrowDown,
    ArrowLeft,
    ArrowRight,
    ArrowUp,
    NumLock,
    Numpad0,
    Numpad1,
    Numpad2,
    Numpad3,
    Numpad4,
    Numpad5,
    Numpad6,
    Numpad7,
    Numpad8,
    Numpad9,
    NumpadAdd,
    NumpadBackspace,
    NumpadClear,
    NumpadClearEntry,
    NumpadComma,
    NumpadDecimal,
    NumpadDivide,
    NumpadEnter,
    NumpadEqual,
    NumpadHash,
    NumpadMemoryAdd,
    NumpadMemoryClear,
    NumpadMemoryRecall,
    NumpadMemoryStore,
    NumpadMemorySubtract,
    NumpadMultiply,
    NumpadParenLeft,
    NumpadParenRight,
    NumpadStar,
    NumpadSubtract,
    Escape,
    Fn,
    FnLock,
    PrintScreen,
    ScrollLock,
    Pause,
    BrowserBack,
    BrowserFavorites,
    BrowserForward,
    BrowserHome,
    BrowserRefresh,
    BrowserSearch,
    BrowserStop,
    Eject,
    LaunchApp1,
    LaunchApp2,
    LaunchMail,
    MediaPlayPause,
    MediaSelect,
    MediaStop,
    MediaTrackNext,
    MediaTrackPrevious,
    Power,
    Sleep,
    AudioVolumeDown,
    AudioVolumeMute,
    AudioVolumeUp,
    WakeUp,
    Meta,
    Hyper,
    Turbo,
    Abort,
    Resume,
    Suspend,
    Again,
    Copy,
    Cut,
    Find,
    Open,
    Paste,
    Props,
    Select,
    Undo,
    Hiragana,
    Katakana,
    F1,
    F2,
    F3,
    F4,
    F5,
    F6,
    F7,
    F8,
    F9,
    F10,
    F11,
    F12,
    F13,
    F14,
    F15,
    F16,
    F17,
    F18,
    F19,
    F20,
    F21,
    F22,
    F23,
    F24,
    F25,
    F26,
    F27,
    F28,
    F29,
    F30,
    F31,
    F32,
    F33,
    F34,
    F35,
}

Represents the location of a physical key.

This mostly conforms to the UI Events Specification’s KeyboardEvent.code with a few exceptions:

• The keys that the specification calls “MetaLeft” and “MetaRight” are named “SuperLeft” and “SuperRight” here.
• The key that the specification calls “Super” is reported as Unidentified here.
• The Unidentified variant here, can still identify a key through it’s NativeKeyCode.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Unidentified(NativeKeyCode)

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

The native keycode is provided (if available) so you’re able to more reliably match key-press and key-release events by hashing the KeyCode. It is also possible to use this for key-binds for non-standard keys, but such key-binds are tied to a given platform.

Backquote = 1

` on a US keyboard. This is also called a backtick or grave. This is the 半角/全角/漢字 (hankaku/zenkaku/kanji) key on Japanese keyboards

Backslash

Used for both the US \ (on the 101-key layout) and also for the key located between the “ and Enter keys on row C of the 102-, 104- and 106-key layouts. Labeled # on a UK (102) keyboard.

BracketLeft

[ on a US keyboard.

BracketRight

] on a US keyboard.

Comma

, on a US keyboard.

Digit0

0 on a US keyboard.

Digit1

1 on a US keyboard.

Digit2

2 on a US keyboard.

Digit3

3 on a US keyboard.

Digit4

4 on a US keyboard.

Digit5

5 on a US keyboard.

Digit6

6 on a US keyboard.

Digit7

7 on a US keyboard.

Digit8

8 on a US keyboard.

Digit9

9 on a US keyboard.

Equal

= on a US keyboard.

IntlBackslash

Located between the left Shift and Z keys. Labeled \ on a UK keyboard.

IntlRo

Located between the / and right Shift keys. Labeled \ (ro) on a Japanese keyboard.

IntlYen

Located between the = and Backspace keys. Labeled ¥ (yen) on a Japanese keyboard. \ on a Russian keyboard.

KeyA

a on a US keyboard. Labeled q on an AZERTY (e.g., French) keyboard.

KeyB

b on a US keyboard.

KeyC

c on a US keyboard.

KeyD

d on a US keyboard.

KeyE

e on a US keyboard.

KeyF

f on a US keyboard.

KeyG

g on a US keyboard.

KeyH

h on a US keyboard.

KeyI

i on a US keyboard.

KeyJ

j on a US keyboard.

KeyK

k on a US keyboard.

KeyL

l on a US keyboard.

KeyM

m on a US keyboard.

KeyN

n on a US keyboard.

KeyO

o on a US keyboard.

KeyP

p on a US keyboard.

KeyQ

q on a US keyboard. Labeled a on an AZERTY (e.g., French) keyboard.

KeyR

r on a US keyboard.

KeyS

s on a US keyboard.

KeyT

t on a US keyboard.

KeyU

u on a US keyboard.

KeyV

v on a US keyboard.

KeyW

w on a US keyboard. Labeled z on an AZERTY (e.g., French) keyboard.

KeyX

x on a US keyboard.

KeyY

y on a US keyboard. Labeled z on a QWERTZ (e.g., German) keyboard.

KeyZ

z on a US keyboard. Labeled w on an AZERTY (e.g., French) keyboard, and y on a QWERTZ (e.g., German) keyboard.

Minus

- on a US keyboard.

Period

. on a US keyboard.

Quote

’ on a US keyboard.

Semicolon

; on a US keyboard.

Slash

/ on a US keyboard.

AltLeft

Alt, Option, or ⌥.

AltRight

Alt, Option, or ⌥. This is labelled AltGr on many keyboard layouts.

Backspace

Backspace or ⌫. Labeled Delete on Apple keyboards.

CapsLock

CapsLock or ⇪

ContextMenu

The application context menu key, which is typically found between the right Super key and the right Ctrl key.

CtrlLeft

Ctrl or ⌃

CtrlRight

Ctrl or ⌃

Enter

Enter or ↵. Labeled Return on Apple keyboards.

SuperLeft

The Windows, ⌘, Command, or other OS symbol key.

SuperRight

The Windows, ⌘, Command, or other OS symbol key.

ShiftLeft

Shift or ⇧

ShiftRight

Shift or ⇧

Space

(space)

Tab

Tab or ⇥

Convert

Japanese: 変 (henkan)

KanaMode

Japanese: カタカナ/ひらがな/ローマ字 (katakana/hiragana/romaji)

Lang1

Korean: HangulMode 한/영 (han/yeong)

Japanese (Mac keyboard): か (kana)

Lang2

Korean: Hanja 한 (hanja)

Japanese (Mac keyboard): 英 (eisu)

Lang3

Japanese (word-processing keyboard): Katakana

Lang4

Japanese (word-processing keyboard): Hiragana

Lang5

Japanese (word-processing keyboard): Zenkaku/Hankaku

NonConvert

Japanese: 無変換 (muhenkan)

Delete

⌦. The forward delete key. Note that on Apple keyboards, the key labelled Delete on the main part of the keyboard is encoded as Backspace.

End

Page Down, End, or ↘

Help

Help. Not present on standard PC keyboards.

Home

Home or ↖

Insert

Insert or Ins. Not present on Apple keyboards.

PageDown

Page Down, PgDn, or ⇟

PageUp

Page Up, PgUp, or ⇞

ArrowDown

↓

ArrowLeft

←

ArrowRight

→

ArrowUp

↑

NumLock

On the Mac, this is used for the numpad Clear key.

Numpad0

0 Ins on a keyboard. 0 on a phone or remote control

Numpad1

1 End on a keyboard. 1 or 1 QZ on a phone or remote control

Numpad2

2 ↓ on a keyboard. 2 ABC on a phone or remote control

Numpad3

3 PgDn on a keyboard. 3 DEF on a phone or remote control

Numpad4

4 ← on a keyboard. 4 GHI on a phone or remote control

Numpad5

5 on a keyboard. 5 JKL on a phone or remote control

Numpad6

6 → on a keyboard. 6 MNO on a phone or remote control

Numpad7

7 Home on a keyboard. 7 PQRS or 7 PRS on a phone or remote control

Numpad8

8 ↑ on a keyboard. 8 TUV on a phone or remote control

Numpad9

9 PgUp on a keyboard. 9 WXYZ or 9 WXY on a phone or remote control

NumpadAdd

+

NumpadBackspace

Found on the Microsoft Natural Keyboard.

NumpadClear

C or A (All Clear). Also for use with numpads that have a Clear key that is separate from the NumLock key. On the Mac, the numpad Clear key is encoded as NumLock.

NumpadClearEntry

C (Clear Entry)

NumpadComma

, (thousands separator). For locales where the thousands separator is a “.” (e.g., Brazil), this key may generate a ..

NumpadDecimal

. Del. For locales where the decimal separator is “,” (e.g., Brazil), this key may generate a ,.

NumpadDivide

/

NumpadEnter

↵

NumpadEqual

=

NumpadHash

# on a phone or remote control device. This key is typically found below the 9 key and to the right of the 0 key.

NumpadMemoryAdd

M Add current entry to the value stored in memory.

NumpadMemoryClear

M Clear the value stored in memory.

NumpadMemoryRecall

M Replace the current entry with the value stored in memory.

NumpadMemoryStore

M Replace the value stored in memory with the current entry.

NumpadMemorySubtract

M Subtract current entry from the value stored in memory.

NumpadMultiply

on a keyboard. For use with numpads that provide mathematical operations (+, - and /).

Use NumpadStar for the * key on phones and remote controls.

NumpadParenLeft

( Found on the Microsoft Natural Keyboard.

NumpadParenRight

) Found on the Microsoft Natural Keyboard.

NumpadStar

* on a phone or remote control device.

This key is typically found below the 7 key and to the left of the 0 key.

Use “NumpadMultiply” for the * key on numeric keypads.

NumpadSubtract

-

Escape

Esc or ⎋

Fn

Fn This is typically a hardware key that does not generate a separate code.

FnLock

FLock or FnLock. Function Lock key. Found on the Microsoft Natural Keyboard.

PrintScreen

PrtScr SysRq or Print Screen

ScrollLock

Scroll Lock

Pause

Pause Break

BrowserBack

Some laptops place this key to the left of the ↑ key.

This also the “back” button (triangle) on Android.

BrowserFavorites

Browser Favorites key.

BrowserForward

Some laptops place this key to the right of the ↑ key.

BrowserHome

The “home” button on Android.

BrowserRefresh

Browser Refresh key.

BrowserSearch

Browser Search key.

BrowserStop

Browser Search key.

Eject

Eject or ⏏. This key is placed in the function section on some Apple keyboards.

LaunchApp1

Sometimes labelled My Computer on the keyboard

LaunchApp2

Sometimes labelled Calculator on the keyboard

LaunchMail

✉

MediaPlayPause

⏯

MediaSelect

Select Media key.

MediaStop

⏹

MediaTrackNext

⏭

MediaTrackPrevious

⏮

Power

This key is placed in the function section on some Apple keyboards, replacing the Eject key.

Sleep

Computer Sleep key.

AudioVolumeDown

Volume Down key.

AudioVolumeMute

Volume Mute key.

AudioVolumeUp

Volume Up key.

WakeUp

Wakes up the device if it is not already awake.

Meta

Legacy modifier key. Also called “Super” in certain places.

Hyper

Legacy modifier key.

Turbo

Legacy under-clock key.

Abort

Legacy abort key.

Resume

Legacy resume key.

Suspend

Legacy suspend key.

Again

Found on Sun’s USB keyboard.

Copy

Found on Sun’s USB keyboard.

Cut

Found on Sun’s USB keyboard.

Find

Found on Sun’s USB keyboard.

Open

Found on Sun’s USB keyboard.

Paste

Found on Sun’s USB keyboard.

Props

Found on Sun’s USB keyboard.

Select

Found on Sun’s USB keyboard.

Undo

Found on Sun’s USB keyboard.

Hiragana

Use for dedicated ひらがな key found on some Japanese word processing keyboards.

Katakana

Use for dedicated カタカナ key found on some Japanese word processing keyboards.

F1

General-purpose function key. Usually found at the top of the keyboard.

F2

General-purpose function key. Usually found at the top of the keyboard.

F3

General-purpose function key. Usually found at the top of the keyboard.

F4

General-purpose function key. Usually found at the top of the keyboard.

F5

General-purpose function key. Usually found at the top of the keyboard.

F6

General-purpose function key. Usually found at the top of the keyboard.

F7

General-purpose function key. Usually found at the top of the keyboard.

F8

General-purpose function key. Usually found at the top of the keyboard.

F9

General-purpose function key. Usually found at the top of the keyboard.

F10

General-purpose function key. Usually found at the top of the keyboard.

F11

General-purpose function key. Usually found at the top of the keyboard.

F12

General-purpose function key. Usually found at the top of the keyboard.

F13

General-purpose function key. Usually found at the top of the keyboard.

F14

General-purpose function key. Usually found at the top of the keyboard.

F15

General-purpose function key. Usually found at the top of the keyboard.

F16

General-purpose function key. Usually found at the top of the keyboard.

F17

General-purpose function key. Usually found at the top of the keyboard.

F18

General-purpose function key. Usually found at the top of the keyboard.

F19

General-purpose function key. Usually found at the top of the keyboard.

F20

General-purpose function key. Usually found at the top of the keyboard.

F21

General-purpose function key. Usually found at the top of the keyboard.

F22

General-purpose function key. Usually found at the top of the keyboard.

F23

General-purpose function key. Usually found at the top of the keyboard.

F24

General-purpose function key. Usually found at the top of the keyboard.

F25

General-purpose function key.

F26

General-purpose function key.

F27

General-purpose function key.

F28

General-purpose function key.

F29

General-purpose function key.

F30

General-purpose function key.

F31

General-purpose function key.

F32

General-purpose function key.

F33

General-purpose function key.

F34

General-purpose function key.

F35

General-purpose function key.

Implementations

impl KeyCode

pub fn is_unidentified(&self) -> bool

If key-code is fully unidentified (NativeKeyCode::Unidentified).

pub fn is_modifier(&self) -> bool

If the keycode represents a known and identified modifier.

pub fn is_composition(&self) -> bool

If the key if for IME composition actions as defined by w3.

pub fn is_editing(&self) -> bool

If the key is for an edit action as defined by w3.

pub fn is_ui(&self) -> bool

If the key is for an general UI action as defined by w3.

pub fn is_device(&self) -> bool

If the key is for an general device action as defined by w3.

pub fn is_function(&self) -> bool

If the key is one of the general purpose function keys.

pub fn is_multimedia(&self) -> bool

If the key is for an multimedia control as defined by w3.

pub fn is_audio(&self) -> bool

If the key is for an audio control as defined by w3.

pub fn is_launch(&self) -> bool

If the key is for launching an application.

pub fn is_browser(&self) -> bool

If the key is for a browser control.

pub fn all_identified() -> impl ExactSizeIterator + DoubleEndedIterator

Iterate over all identified values.

The first value is Backquote the last is F35.

pub fn name(self) -> &'static str

Gets the key as a static str.

Trait Implementations

impl Clone for KeyCode

fn clone(&self) -> KeyCode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for KeyCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KeyCode

fn deserialize<__D>( __deserializer: __D, ) -> Result<KeyCode, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromStr for KeyCode

Gets the identified key name or Unidentified

type Err = KeyCode

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<KeyCode, <KeyCode as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for KeyCode

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 PartialEq for KeyCode

fn eq(&self, other: &KeyCode) -> 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 Serialize for KeyCode

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<KeyCode> for GestureKey

Accepts only keys that are not is_modifier and not is_composition.

type Error = KeyCode

The type returned in the event of a conversion error.

fn try_from( key: KeyCode, ) -> Result<GestureKey, <GestureKey as TryFrom<KeyCode>>::Error>

Performs the conversion.

impl TryFrom<KeyCode> for ModifierGesture

type Error = KeyCode

The type returned in the event of a conversion error.

fn try_from( value: KeyCode, ) -> Result<ModifierGesture, <ModifierGesture as TryFrom<KeyCode>>::Error>

Performs the conversion.

impl Copy for KeyCode

impl Eq for KeyCode

impl StructuralPartialEq for KeyCode