Enum ButtonId 

pub enum ButtonId {
    LeftClick,
    RightClick,
    MiddleClick,
    Back,
    Forward,
    DpiToggle,
    Thumbwheel,
    ThumbwheelScrollUp,
    ThumbwheelScrollDown,
    GestureButton,
    KeySearch,
    KeyDictation,
    KeyEmoji,
    KeyScreenCapture,
    KeyMicMute,
    KeyPlayPause,
    KeyMute,
    KeyVolumeDown,
    KeyVolumeUp,
    HapticPanel,
    WheelTiltLeft,
    WheelTiltRight,
}

One of the user-rebindable hotspots on a Logi mouse. The order matches the physical layout from front to side; ButtonId::ALL is consumed by the default-binding generator and the popover trigger list.

Variants

LeftClick

The primary button. Rebindable in the config schema, but the OS hook never suppresses it — see ButtonId::is_os_hook_button.

RightClick

The secondary button. Like ButtonId::LeftClick, it always passes through the OS hook.

MiddleClick

The wheel click — one of the three buttons the OS hook remaps.

Back

The thumb-side “back” button (mouse button 4), remapped by the OS hook.

Forward

The thumb-side “forward” button (mouse button 5), remapped by the OS hook.

DpiToggle

The “ModeShift” button under the wheel — typically used for SmartShift / DPI cycle. Named DpiToggle for historical reasons.

Thumbwheel

The horizontal thumb wheel’s click. Kept in ButtonId::ALL so its default still seeds and dispatches when the wheel is diverted, even though the mouse model surfaces one paired rotation control instead of the click (see mouse_model::geometry).

ThumbwheelScrollUp

Rotating the thumb wheel “up” (positive rotation). Bound, by default, to continuous horizontal scroll; see the agent-core watchers-side dispatch.

ThumbwheelScrollDown

Rotating the thumb wheel “down” (negative rotation).

GestureButton

The HID++ gesture button on MX-line devices. The press itself fires the bound action; swipe directions are P1.5 territory.

KeySearch

Keyboard F-row “Search” control (0x1b04 CID 0x00d4, MultiPlatform_Search) — F4 on the Signature series.

KeyDictation

Keyboard “Dictation” control (CID 0x0103) — F5 on the Signature series.

KeyEmoji

Keyboard “Emoji” control (CID 0x0108) — F6 on the Signature series.

KeyScreenCapture

Keyboard “Screen Capture” control (CID 0x010a) — F7 on the Signature series.

KeyMicMute

Keyboard “Mute Microphone” control (CID 0x011c) — F8 on the Signature series.

KeyPlayPause

Keyboard “Play/Pause” control (CID 0x00e5) — F9 on the Signature series.

KeyMute

Keyboard “Mute” control (CID 0x00e7) — F10 on the Signature series.

KeyVolumeDown

Keyboard “Volume Down” control (CID 0x00e8) — F11 on the Signature series.

KeyVolumeUp

Keyboard “Volume Up” control (CID 0x00e9) — F12 on the Signature series.

HapticPanel

The MX Master 4 Haptic Sense Panel — the touch-sensitive thumb rest (Logi metadata slot ASSIGNMENT_NAME_SHOW_RADIAL_MENU, HID++ CID 0x01a0). A separate physical control from ButtonId::GestureButton; captured over HID++ like it, and eligible as the gesture owner.

WheelTiltLeft

Tilting the main wheel left — 0x1b04 CID 0x005b (“Left Scroll”), Logi metadata slot SLOT_NAME_LEFT_SCROLL_BUTTON. A distinct control from the thumb wheel: it is a plain divertable button, not a rotation, and it lives on the main wheel of mice like the MX Anywhere 2S.

WheelTiltRight

Tilting the main wheel right — 0x1b04 CID 0x005d (“Right Scroll”), Logi metadata slot SLOT_NAME_RIGHT_SCROLL_BUTTON. Counterpart to ButtonId::WheelTiltLeft.

Declared last: the TOML config and any serialized form encode the variant identifier / index, so new buttons are append-only.

Implementations

impl ButtonId

pub const ALL: [ButtonId; 13]

Every rebindable button in declaration (physical front-to-side) order — the iteration source for default-binding seeding and the popover trigger list.

pub const KEYBOARD_KEYS: [ButtonId; 9]

The divertable keyboard F-row controls, in F-row order. Kept out of ButtonId::ALL: that array seeds mouse defaults and the mouse popover trigger list, while keyboard keys stay native unless the user binds them (an unbound key is never diverted).

pub fn is_os_hook_button(self) -> bool

Whether this button is one the OS hook (macOS CGEventTap / Linux evdev) remaps: Middle, Back, or Forward. The primary L/R clicks always pass through (suppressing them would brick the mouse), and the DPI / thumb / dedicated gesture controls aren’t visible to the OS hook at all (they’re captured over HID++). Stored gesture bindings also project through this set so Middle Click configurations written by v0.8.0 keep working; Self::supports_gesture_mode separately controls which buttons may be newly promoted by the UI.

pub fn is_os_hook_gesture_source(self) -> bool

Whether this button may use the OS hook’s hold-and-swipe gesture path. Back and Forward are the only eligible controls: Middle Click belongs to the main wheel, whose controls intentionally remain single-action.

pub fn is_hidpp_gesture_source(self) -> bool

Whether this button is a HID++ gesture source — a control that is captured over HID++ raw-XY diversion (never the OS hook) and can therefore own the gesture role with swipe directions: DPI/ModeShift, the dedicated gesture button, or the MX Master 4 haptic panel. The capture layer maps each to its control ID and checks the device’s advertised raw-XY capability before arming it.

pub fn supports_gesture_mode(self) -> bool

Whether OpenLogi offers gesture mode for this logical control. Wheel controls and the primary clicks stay single-action by product policy; device-specific HID++ capability checks may further narrow this set at capture time.

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

Human-readable label for popovers and tooltips.

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

Stable catalog key for the localized button label.

Trait Implementations

impl Clone for ButtonId

fn clone(&self) -> ButtonId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ButtonId

impl Debug for ButtonId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ButtonId

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ButtonId

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

Formats the value using the given formatter.

impl Eq for ButtonId

impl Hash for ButtonId

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 ButtonId

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

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for ButtonId

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ButtonId

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Serialize for ButtonId

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 StructuralPartialEq for ButtonId