Enum Binding 

pub enum Binding {
    Single(Action),
    Gesture(BTreeMap<GestureDirection, Action>),
    LongPress(LongPressBinding),
}

What a single rebindable ButtonId does: one immediate Action, an independent short/long action pair, or — for a raw-XY-capable button placed in gesture mode — a per-GestureDirection map (hold + swipe up/down/left/right, or a plain click).

There has only ever been one binding map per device; a gesture binding is just a binding whose payload is a direction map instead of a single action.

Serialization

#[serde(untagged)]: Single serializes exactly as the bare Action did before (a string "BrowserBack", or a single-key table for the payload variants), Gesture serializes as a table keyed by GestureDirection names (Up/Down/Left/Right/ Click), and LongPress as the structurally distinct { short = ..., long = ... } table.

The arms are disambiguated structurally: action variant names and gesture direction names have zero overlap, while a long press requires both lowercase short and long fields and rejects unknown fields. The binding_untagged_* tests guard these routing invariants.

Variants

Single(Action)

One action, fired on press. The shape every non-gesture button uses.

Gesture(BTreeMap<GestureDirection, Action>)

Per-direction sub-bindings for a button in gesture mode. Keyed by the committed swipe direction, with GestureDirection::Click holding the plain-click (no-swipe) action.

LongPress(LongPressBinding)

Independent release-before-threshold and threshold actions.

Implementations

impl Binding

pub fn click_action(&self) -> Action

The plain-click action for this binding: the Single action, the Gesture map’s Click entry, or a LongPress binding’s short action. Falls back to Action::None when a gesture binding has no explicit Click.

Lets the click-dispatch path stay binding-shape-agnostic.

pub fn direction_action(&self, direction: GestureDirection) -> Option<&Action>

The action bound to direction, if this is a gesture binding. Single has no directions and returns None.

pub fn is_gesture(&self) -> bool

Whether this binding drives raw-XY swipe capture (the Gesture arm).

pub fn upgrade_to_gesture(&mut self)

Promote a Single binding in place to a Gesture, keeping its action as the GestureDirection::Click entry and leaving the swipe arms unbound. A long-press binding keeps its short action as Click; its long action is discarded because gesture and threshold modes are mutually exclusive. A no-op when this is already a Gesture.

pub fn demote_to_single(&mut self, fallback: Action)

Demote a Gesture binding in place to a Single of its Click entry, falling back to fallback when the map has no explicit Click — the inverse of Self::upgrade_to_gesture. A no-op on a Single or LongPress.

pub fn fill_gesture_defaults(&mut self)

Fill any unbound directions of a Gesture binding with their canonical default_gesture_binding, so a button promoted to the gesture role always exposes the full five-direction set — rather than leaving swipe arms the GUI renders as defaults but the runtime never dispatches. A no-op on Single and on directions already bound (existing user choices are preserved).

Trait Implementations

impl Clone for Binding

fn clone(&self) -> Binding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Binding

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Binding

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Binding

impl From<Action> for Binding

fn from(action: Action) -> Self

Converts to this type from the input type.

impl PartialEq for Binding

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Binding

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Binding