Struct PointerChange 

pub struct PointerChange {
    pub timestamp: Instant,
    pub pointer_id: PointerId,
    pub content: CursorEventContent,
    pub gesture_state: GestureState,
    /* private fields */
}

Represents a single pointer change with timing information.

PointerChange encapsulates all pointer interactions including presses, releases, and scroll actions. Each event includes a timestamp for precise timing and ordering of input events.

Fields

timestamp: Instant

Timestamp indicating when this event occurred.

pointer_id: PointerId

Pointer identifier for this input stream.

content: CursorEventContent

The specific type and data of this pointer change.

gesture_state: GestureState

Classification of the gesture associated with this event.

Events originating from touch scrolling will mark this as GestureState::Dragged, allowing downstream components to distinguish tap candidates from scroll gestures.

Implementations

impl PointerChange

pub fn new( timestamp: Instant, pointer_id: PointerId, content: CursorEventContent, gesture_state: GestureState, ) -> Self

Creates an unconsumed pointer sample with an explicit event timestamp.

pub fn with_position(self, position: impl Into<Option<PxPosition>>) -> Self

Associates the sample with its window position at the time of input.

Passing None records an unavailable position rather than using a later cursor location. Movement events always use their own coordinates.

pub fn position(&self) -> Option<PxPosition>

Returns the sample’s recorded absolute position, when available.

pub fn is_discrete_scroll(&self) -> bool

Returns whether this scroll sample represents a discrete wheel step.

The classification follows the original input when an ancestor receives a smaller remainder or a different coordinate space.

pub fn consume(&mut self)

Marks this change as consumed.

pub fn is_consumed(&self) -> bool

Returns whether this change has already been consumed.

pub fn claim_tap_press(&mut self) -> bool

Claims a press for one tap recognizer without consuming the sample.

Returns false for a non-press sample or a press already claimed by another recognizer. Drag and scroll observers can still inspect it.

Trait Implementations

impl Clone for PointerChange

fn clone(&self) -> PointerChange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PointerChange

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

Formats the value using the given formatter.