Enum kas::event::Command

#[non_exhaustive]
pub enum Command {
    Escape,
    Activate,
    Enter,
    Space,
    Tab,
    ViewUp,
    ViewDown,
    Left,
    Right,
    Up,
    Down,
    WordLeft,
    WordRight,
    Home,
    End,
    DocHome,
    DocEnd,
    PageUp,
    PageDown,
    Snapshot,
    ScrollLock,
    Pause,
    Insert,
    Delete,
    DelBack,
    DelWord,
    DelWordBack,
    Deselect,
    SelectAll,
    Find,
    FindReplace,
    FindNext,
    FindPrevious,
    Bold,
    Italic,
    Underline,
    Link,
    Cut,
    Copy,
    Paste,
    Undo,
    Redo,
    New,
    Open,
    Save,
    Print,
    NavNext,
    NavPrevious,
    NavParent,
    NavDown,
    TabNew,
    TabNext,
    TabPrevious,
    Help,
    Rename,
    Refresh,
    Debug,
    SpellCheck,
    ContextMenu,
    Menu,
    Fullscreen,
    Close,
    Exit,
}

Command input (Event::Command)

Command events are mostly produced as a result of OS-specific keyboard bindings; for example, Command::Copy is produced by pressing Command+C on MacOS or Ctrl+C on other platforms. See crate::event::config::Shortcuts for more on these bindings.

A Command event does not necessarily come from keyboard input; for example some menu widgets send Command::Activate to trigger an entry as a result of mouse input.

Most Command entries represent an action (such as Copy or FindNext) but some represent an important key whose action may be context-dependent (e.g. Escape, Space).

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.

Escape

Escape key

Each press of this key should somehow relax control. It is expected that widgets receiving this key repeatedly eventually (soon) have no more use for this themselves and return it via Unused.

This is in some cases remapped to Command::Deselect.

Activate

Programmatic activation

A synthetic event to activate widgets. Consider matching Command::is_activate or using using Event::on_activate instead for generally applicable activation.

Enter

Return / enter key

This may insert a line-break or may activate something.

Space

Space bar key

Tab

Tab key

This key is used to insert (horizontal) tabulators as well as to navigate focus (in reverse when combined with Shift).

This is usually not sent to widgets but instead used for navigation.

ViewUp

Move view up without affecting selection

ViewDown

Move view down without affecting selection

Left

Move left

Right

Move right

Up

Move up

Down

Move down

WordLeft

Move left one word

WordRight

Move right one word

Home

Move to start (of the line)

End

Move to end (of the line)

DocHome

Move to start of the document

DocEnd

Move to end of the document

PageUp

Move up a page

PageDown

Move down a page

Snapshot

Capture a screenshot

ScrollLock

Lock output of screen

Pause

Pause key

Insert

Insert key

Delete

Delete forwards

DelBack

Delete backwards (Backspace key)

DelWord

Delete forwards one word

DelWordBack

Delete backwards one word

Deselect

Clear any selections

SelectAll

Select all contents

Find

Find (start)

FindReplace

Find and replace (start)

FindNext

Find next

FindPrevious

Find previous

Bold

Make text bold

Italic

Make text italic

Underline

Underline text

Link

Insert a link

Cut

Copy to clipboard and clear

Copy

Copy to clipboard

Paste

Copy from clipboard

Undo

Undo the last action

Redo

Redo the last undone action

New

New document

Open

Open document

Save

Save document

Print

Print document

NavNext

Navigate forwards one page/item

NavPrevious

Navigate backwards one page/item

NavParent

Navigate to the parent item

May be used to browse “up” to a parent directory.

NavDown

Navigate “down”

This is an opposite to NavParent, and will mostly not be used.

TabNew

Open a new tab

TabNext

Navigate to next tab

TabPrevious

Navigate to previous tab

Help

Show help

Rename

Rename

Refresh

Refresh

Debug

Debug

SpellCheck

Spell-check tool

ContextMenu

Open the context menu

Menu

Open or activate the application menu / menubar

Fullscreen

Make view fullscreen

Close

Close window/tab/popup

Exit

Exit program (e.g. Ctrl+Q)

Implementations

impl Command

pub fn new(key: &Key) -> Option<Command>

Try constructing from a winit::keyboard::Key

pub fn is_activate(self) -> bool

True for “activation” commands

This matches:

• Self::Activate — programmatic activation
• Self::Enter — Enter and Return keys
• Self::Space — Space key

pub fn suitable_for_sel_focus(self) -> bool

Convert to selection-focus command

Certain limited commands may be sent to widgets with selection focus but not character or navigation focus.

pub fn as_direction(self) -> Option<Direction>

Convert arrow keys to a direction

Trait Implementations

impl Clone for Command

fn clone(&self) -> Command

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Command

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

Formats the value using the given formatter.

impl Hash for Command

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 Ord for Command

fn cmp(&self, other: &Command) -> 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 + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for Command

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

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Copy for Command

impl Eq for Command

impl StructuralEq for Command

impl StructuralPartialEq for Command