Enum ButtonId 

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

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.

Implementations

impl ButtonId

pub const ALL: [ButtonId; 10]

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++). These are exactly the buttons that can become an OS-hook gesture button, so the hook’s remap gate and the gesture-owner projection share this one definition.

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

Human-readable label for popovers and tooltips.

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.

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