zng_ext_input::keyboard

Enum KeyCode

source
#[non_exhaustive]
#[repr(u16)]
pub enum KeyCode {
Show 195 variants 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,
}
Expand description

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)§

This enum is marked as 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§

source§

impl KeyCode

source

pub fn is_unidentified(&self) -> bool

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

source

pub fn is_modifier(&self) -> bool

If the keycode represents a known and identified modifier.

source

pub fn is_composition(&self) -> bool

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

source

pub fn is_editing(&self) -> bool

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

source

pub fn is_ui(&self) -> bool

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

source

pub fn is_device(&self) -> bool

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

source

pub fn is_function(&self) -> bool

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

source

pub fn is_multimedia(&self) -> bool

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

source

pub fn is_audio(&self) -> bool

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

source

pub fn is_launch(&self) -> bool

If the key is for launching an application.

source

pub fn is_browser(&self) -> bool

If the key is for a browser control.

source

pub fn all_identified() -> impl ExactSizeIterator + DoubleEndedIterator

Iterate over all identified values.

The first value is Backquote the last is F35.

source

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

Gets the key as a static str.

Trait Implementations§

source§

impl Clone for KeyCode

source§

fn clone(&self) -> KeyCode

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for KeyCode

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

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

Deserialize this value from the given Serde deserializer. Read more
source§

impl FromStr for KeyCode

Gets the identified key name or Unidentified

source§

type Err = KeyCode

The associated error which can be returned from parsing.
source§

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

Parses a string s to return a value of this type. Read more
source§

impl Hash for KeyCode

source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more
source§

impl PartialEq for KeyCode

source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

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

impl Serialize for KeyCode

source§

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. Read more
source§

impl Copy for KeyCode

source§

impl Eq for KeyCode

source§

impl StructuralPartialEq for KeyCode

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> AnyVarValue for T
where T: VarValue,

source§

fn as_any(&self) -> &(dyn Any + 'static)

Access to dyn Any methods.
source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Access to mut dyn Any methods.
source§

fn clone_boxed(&self) -> Box<dyn AnyVarValue>

Clone the value.
source§

fn clone_boxed_var(&self) -> Box<dyn AnyVar>

Clone the value into a new boxed LocalVar<Self>.
source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Access to Box<dyn Any> methods.
source§

fn eq_any(&self, other: &(dyn AnyVarValue + 'static)) -> bool

Gets if self equals other.
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> IntoVar<T> for T
where T: VarValue,

source§

type Var = LocalVar<T>

Variable type that will wrap the T value. Read more
source§

fn into_var(self) -> <T as IntoVar<T>>::Var

Converts the source value into a var.
source§

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>
where Self: Sized,

Converts into BoxedVar<T>. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> Same for T

source§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

source§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

source§

impl<T> IntoValue<T> for T
where T: VarValue,

source§

impl<T> IpcValue for T
where T: Debug + Serialize + for<'d> Deserialize<'d> + Send + 'static,

source§

impl<T> StateValue for T
where T: Any + Send + Sync,

source§

impl<T> VarValue for T
where T: Debug + Clone + PartialEq + Any + Send + Sync,