Skip to main content

Action

Enum Action 

Source
pub enum Action {
Show 45 variants None, LeftClick, RightClick, MiddleClick, MouseBack, MouseForward, Copy, Paste, Cut, Undo, Redo, SelectAll, Find, Save, BrowserBack, BrowserForward, NewTab, CloseTab, ReopenTab, NextTab, PrevTab, ReloadPage, MissionControl, AppExpose, PreviousDesktop, NextDesktop, ShowDesktop, LaunchpadShow, LockScreen, Screenshot, CaptureRegion, PlayPause, NextTrack, PrevTrack, VolumeUp, VolumeDown, MuteVolume, CycleDpiPresets, SetDpiPreset(u8), ToggleSmartShift, ScrollUp, ScrollDown, HorizontalScrollLeft, HorizontalScrollRight, CustomShortcut(KeyCombo),
}
Expand description

What pressing a ButtonId should do.

Serialization uses serde’s default external tagging: unit variants serialize as a bare string ("BrowserBack") and the tuple variant serializes as a single-key table ({ CustomShortcut = "my chord" }).

Stability contract: existing variant names are frozen — they form the on-disk config.toml schema. New variants may be appended freely; removing or renaming a variant requires a schema_version bump and a migration.

This type is pure config data: OS-level event synthesis for each variant lives in the openlogi-inject crate (openlogi_inject::execute), keeping this crate platform- and IO-free.

Variants§

§

None

Suppress the input entirely — the button or wheel direction is captured but no OS event is synthesised, so the physical input does nothing.

§

LeftClick

Primary mouse button.

§

RightClick

Secondary mouse button.

§

MiddleClick

Middle mouse button (wheel click).

§

MouseBack

Mouse “back” side button (extra button 4). Synthesizes the real mouse button event, which browsers and most apps interpret as “navigate back” natively — unlike Action::BrowserBack, which sends ⌘[ and is ignored by many apps.

§

MouseForward

Mouse “forward” side button (extra button 5). Native counterpart to Action::MouseBack; see Action::BrowserForward for the ⌘] form.

§

Copy

Copy the current selection (⌘C / Ctrl+C).

§

Paste

Paste from the clipboard (⌘V / Ctrl+V).

§

Cut

Cut the current selection (⌘X / Ctrl+X).

§

Undo

Undo the last action (⌘Z / Ctrl+Z).

§

Redo

Redo the last undone action (⌘⇧Z on macOS / Ctrl+Shift+Z on Linux).

Note: Ctrl+Y is the dominant redo shortcut in LibreOffice and many GTK apps. Ctrl+Shift+Z is used here because it mirrors the macOS convention and works in GNOME text fields, browsers, and Electron apps. If Ctrl+Y coverage is needed, a CustomShortcut binding is the escape hatch.

§

SelectAll

Select all content (⌘A / Ctrl+A).

§

Find

Open the find / search bar (⌘F / Ctrl+F).

§

Save

Save the current document (⌘S / Ctrl+S).

§

BrowserBack

Navigate backward in browser history.

§

BrowserForward

Navigate forward in browser history.

§

NewTab

Open a new tab (⌘T / Ctrl+T).

§

CloseTab

Close the current tab (⌘W / Ctrl+W).

§

ReopenTab

Reopen the last closed tab (⌘⇧T / Ctrl+Shift+T).

§

NextTab

Switch to the next tab (⌃⇥ / Ctrl+Tab).

§

PrevTab

Switch to the previous tab (⌃⇧⇥ / Ctrl+Shift+Tab).

§

ReloadPage

Reload the current page (⌘R / Ctrl+R).

§

MissionControl

macOS Mission Control (⌃↑).

§

AppExpose

macOS App Exposé — all windows for the current app (⌃↓).

§

PreviousDesktop

Switch to the previous desktop / Space.

§

NextDesktop

Switch to the next desktop / Space.

§

ShowDesktop

Show the desktop (hide all windows).

§

LaunchpadShow

Open Launchpad.

§

LockScreen

Lock the screen (⌘⌃Q on macOS).

On Linux, calls org.freedesktop.login1.Manager.LockSession($XDG_SESSION_ID) on the system bus (current session only). Falls back to Super+L when $XDG_SESSION_ID is unset or on non-systemd systems.

§

Screenshot

Capture a screenshot.

§

CaptureRegion

Capture a selected screen region to the clipboard.

macOS uses Cmd+Shift+Ctrl+4; Windows uses Win+Shift+S. Linux delegates to the desktop environment’s screenshot handler via Print Screen.

§

PlayPause

Toggle media play/pause.

§

NextTrack

Skip to the next track.

§

PrevTrack

Go back to the previous track.

§

VolumeUp

Increase system volume.

§

VolumeDown

Decrease system volume.

§

MuteVolume

Toggle system mute.

§

CycleDpiPresets

Step through the configured DPI preset list (P1.7).

§

SetDpiPreset(u8)

Jump to a specific zero-based preset in the device’s DPI preset list. Out-of-range indices clamp to the list length at fire time (P1.7).

§

ToggleSmartShift

Toggle the HID++ SmartShift ratchet/free-spin wheel mode (P1.1).

§

ScrollUp

Synthesise a vertical scroll-up tick.

§

ScrollDown

Synthesise a vertical scroll-down tick.

§

HorizontalScrollLeft

Synthesise a horizontal scroll-left tick.

§

HorizontalScrollRight

Synthesise a horizontal scroll-right tick.

§

CustomShortcut(KeyCombo)

Replay an arbitrary recorded key chord (P1.3).

Holds the structured chord data so openlogi_inject::execute can post the real keystroke (macOS: CGEventPost with the encoded modifier flags). The display field is used by Action::label so the popover shows the user-friendly chord name.

Implementations§

Source§

impl Action

Source

pub fn label(&self) -> String

Display label for the popover row.

Returns String rather than &str so parameterized variants (e.g. SetDpiPreset(i), CustomShortcut(s)) can build a label that includes their payload.

Source

pub fn category(&self) -> Category

Which Category this action belongs to, used for popover grouping.

Source

pub fn catalog() -> Vec<Action>

All pickable actions in a deterministic order.

Action::CustomShortcut is intentionally excluded — it is opened via “Record shortcut…” (P1.3), not selected from the catalog.

Trait Implementations§

Source§

impl Clone for Action

Source§

fn clone(&self) -> Action

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 Debug for Action

Source§

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

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

impl<'de> Deserialize<'de> for Action

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 Action

Source§

impl From<Action> for Binding

Source§

fn from(action: Action) -> Self

Converts to this type from the input type.
Source§

impl Hash for Action

Source§

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

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 Action

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · 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 Action

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 Action

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> 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<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<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

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

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

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

impl<T> WithSubscriber for T

Source§

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

fn with_current_subscriber(self) -> WithDispatch<Self>

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