Struct GestureDrag

pub struct GestureDrag { /* private fields */ }

GestureDrag is a Gesture implementation for drags.

The drag operation itself can be tracked throughout the drag-begin, drag-update and drag-end signals, and the relevant coordinates can be extracted through GestureDragExt::offset() and GestureDragExt::start_point().

Signals

drag-begin

Emitted whenever dragging starts.

drag-end

Emitted whenever the dragging is finished.

drag-update

Emitted whenever the dragging point moves.

Gesture

begin

Emitted when the gesture is recognized.

This means the number of touch sequences matches n-points.

Note: These conditions may also happen when an extra touch (eg. a third touch on a 2-touches gesture) is lifted, in that situation @sequence won’t pertain to the current set of active touches, so don’t rely on this being true.

cancel

Emitted whenever a sequence is cancelled.

This usually happens on active touches when EventControllerExt::reset() is called on @gesture (manually, due to grabs…), or the individual @sequence was claimed by parent widgets’ controllers (see GestureExt::set_sequence_state()).

@gesture must forget everything about @sequence as in response to this signal.

end

Emitted when @gesture either stopped recognizing the event sequences as something to be handled, or the number of touch sequences became higher or lower than n-points.

Note: @sequence might not pertain to the group of sequences that were previously triggering recognition on @gesture (ie. a just pressed touch sequence that exceeds n-points). This situation may be detected by checking through GestureExt::handles_sequence().

sequence-state-changed

Emitted whenever a sequence state changes.

See GestureExt::set_sequence_state() to know more about the expectable sequence lifetimes.

update

Emitted whenever an event is handled while the gesture is recognized.

@sequence is guaranteed to pertain to the set of active touches.

Implements

GestureDragExt, GestureSingleExt, GestureExt, EventControllerExt, [trait@glib::ObjectExt]

GLib type: GObject with reference counted clone semantics.

Implementations

impl GestureDrag

pub const NONE: Option<&'static GestureDrag> = None

pub fn new() -> GestureDrag

Returns a newly created Gesture that recognizes drags.

Returns

a newly created GestureDrag

pub fn builder() -> GestureDragBuilder

Creates a new builder-pattern struct instance to construct GestureDrag objects.

This method returns an instance of GestureDragBuilder which can be used to create GestureDrag objects.

Trait Implementations

impl Clone for GestureDrag

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

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

Performs copy-assignment from source.

impl Debug for GestureDrag

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

Formats the value using the given formatter.

impl Default for GestureDrag

fn default() -> Self

Returns the “default value” for a type.

impl HasParamSpec for GestureDrag

type ParamSpec = ParamSpecObject

type SetValue = GestureDrag

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, GestureDrag>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for GestureDrag

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

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 GestureDrag

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

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 ParentClassIs for GestureDrag

type Parent = GestureSingle

impl<OT: ObjectType> PartialEq<OT> for GestureDrag

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

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for GestureDrag

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

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

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 StaticType for GestureDrag

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for GestureDrag

impl IsA<EventController> for GestureDrag

impl IsA<Gesture> for GestureDrag

impl IsA<GestureDrag> for GesturePan

impl IsA<GestureSingle> for GestureDrag