Struct gtk4::GestureDrag

#[repr(transparent)]
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, glib::ObjectExt

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

Returns a copy of the value.

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

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

Formats the value using the given formatter.

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,

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 GestureDrag

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

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

This method tests for self and other values to be equal, and is used by ==.

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

This method 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>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method 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