Skip to main content

Key

Enum Key 

Source
pub enum Key {
Show 27 variants Up, Down, Left, Right, Tab, BackTab, Enter, Space, Esc, Backspace, Delete, Insert, Home, End, PageUp, PageDown, Function(u8), Ctrl(char), Alt(char), CtrlAlt(char), ShiftEnter, WordLeft, WordRight, WordDelete, Paste, PasteRaw, Char(char),
}
Expand description

Decoded keyboard input, terminal-agnostic.

Variants§

§

Up

Arrow up: widget-local cursor until the top edge, then focus ring.

§

Down

Arrow down: widget-local cursor until the bottom edge, then ring.

§

Left

Arrow left: chips/enums/number fields consume; else focus ring.

§

Right

Arrow right: chips/enums/number fields consume; else focus ring.

§

Tab

Next focusable widget (always escapes the current widget).

§

BackTab

Previous focusable widget.

§

Enter

Activate / choose / newline (editor) / press (button).

§

Space

Toggle (checkbox/multi) or activate; literal space in text entry.

§

Esc

Close popup, then clear filter, then cancel the whole dialog.

§

Backspace

Delete before the cursor in text entry.

§

Delete

Delete under the cursor in text entry.

§

Insert

Insert at the cursor.

§

Home

Jump to line/list start.

§

End

Jump to line/list end.

§

PageUp

Scroll one viewport up.

§

PageDown

Scroll one viewport down.

§

Function(u8)

Function key, numbered from F1 through F12.

§

Ctrl(char)

Ctrl-chord with a letter, normalized to lowercase. Text widgets implement the readline set (a e k u w b f d); others ignore.

§

Alt(char)

Alt-chord with a letter, normalized to lowercase, for chords without a canonical cross-terminal meaning (e.g. pi binds alt+y yank-pop). Encoding variants of one physical intent (alt+f/alt+b word motion, alt+d word delete, ESC-CR newline) normalize to their semantic keys instead and never reach this variant.

§

CtrlAlt(char)

Ctrl+Alt chord, normalized to lowercase. Used by pi’s backward character-jump binding and available to embedders for other chords.

§

ShiftEnter

Shift+Enter: literal newline in multiline text entry.

§

WordLeft

Ctrl/Alt+Left: previous word boundary.

§

WordRight

Ctrl/Alt+Right: next word boundary.

§

WordDelete

Alt+D / Alt+Delete: delete forward through the next word end.

§

Paste

Ctrl+V: host-driven clipboard paste, preferring images (see the runtime’s clipboard fallback).

§

PasteRaw

Ctrl+Shift+V: host-driven clipboard paste of text only, inserted verbatim (crate::Component::paste_raw) — no image or file-URL interpretation, no drop classification, no large-paste collapse.

§

Char(char)

Printable input: text entry, type-to-search (/), shortcuts.

Trait Implementations§

Source§

impl Clone for Key

Source§

fn clone(&self) -> Key

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for Key

Source§

impl Debug for Key

Source§

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

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

impl<'de> Deserialize<'de> for Key

Source§

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

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

impl Eq for Key

Source§

impl PartialEq for Key

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl Serialize for Key

Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for Key

Auto Trait Implementations§

§

impl Freeze for Key

§

impl RefUnwindSafe for Key

§

impl Send for Key

§

impl Sync for Key

§

impl Unpin for Key

§

impl UnsafeUnpin for Key

§

impl UnwindSafe for Key

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> 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, dest: *mut u8)

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

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

Source§

impl<T> Downcast for T
where T: Any,

Source§

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

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

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

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

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

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

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

Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

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

Source§

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

Checks if this value is equivalent to the given key. Read more
Source§

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

Source§

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

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

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

Source§

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

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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> 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.