Struct Drag 

pub struct Drag { /* private fields */ }

Bounded two-dimensional drag with explicit ownership of pointer capture/cancellation.

Implementations

impl Drag

pub fn new(initial: [f64; 2], min: [f64; 2], max: [f64; 2]) -> Self

Validates finite ordered bounds and an initial position inside them.

pub fn unconstrained(initial: [f64; 2]) -> Self

Creates a drag without user constraints, bounded only by drawable f32 offsets. Add measured container constraints in a native adapter if needed.

pub fn elasticity(self, value: f64) -> Self

Sets drag resistance outside bounds. Panics unless in zero through one.

pub fn snap_grid(self, spacing: f64) -> Self

Snaps release destinations to this positive finite grid spacing.

pub fn momentum(self, enabled: bool) -> Self

Enables/disables velocity projection on release.

pub fn direction_lock(self, threshold: f64) -> Self

Locks to the first dominant axis after this positive pixel threshold. The threshold suppresses jitter before ownership is chosen.

pub fn locked_axis(&self) -> Option<usize>

Current dynamically chosen axis: zero horizontal, one vertical.

pub fn set_bounds(&mut self, min: [f64; 2], max: [f64; 2], now: Duration)

Updates measured constraints without jumping the presentation. During a pointer gesture resistance uses the new bounds; released values spring back.

pub fn presentation(&self) -> ([f64; 2], [f64; 2])

Last presented position and velocity, without advancing time.

pub fn begin(&mut self, pointer: [f64; 2], now: Duration)

Grabs the currently presented position, interrupting any previous release motion.

pub fn move_to(&mut self, pointer: [f64; 2], now: Duration)

Follows the pointer one-to-one inside bounds, with configured resistance outside.

pub fn end(&mut self, now: Duration)

Releases into bounded inertia, or a velocity-preserving spring to a snap point. Holding still for over 100 ms clears stale pointer momentum before release.

pub fn cancel(&mut self, now: Duration)

Cancels an active drag and returns to the grabbed position. Use on Escape or lost capture. Does nothing after release, so later focus loss cannot undo a completed gesture.

pub fn move_by(&mut self, delta: [f64; 2], now: Duration)

A keyboard equivalent of dragging: retargets a bounded position using a spring.

pub fn sample(&mut self, now: Duration, reduced_motion: bool) -> Frame

Samples a drawable x/y presentation. The owner requests frames while it is active.

pub fn is_dragging(&self) -> bool

Whether a pointer currently owns this gesture.

Trait Implementations

impl Debug for Drag

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

Formats the value using the given formatter.