Struct SwipeTracker

pub struct SwipeTracker { /* private fields */ }

A swipe tracker used in Carousel, NavigationView and OverlaySplitView.

The SwipeTracker object can be used for implementing widgets with swipe gestures. It supports touch-based swipes, pointer dragging, and touchpad scrolling.

The widgets will probably want to expose the enabled property. If they expect to use horizontal orientation, reversed can be used for supporting RTL text direction.

Properties

allow-long-swipes

Whether to allow swiping for more than one snap point at a time.

If the value is FALSE, each swipe can only move to the adjacent snap points.

Readable | Writeable

allow-mouse-drag

Whether to allow dragging with mouse pointer.

Readable | Writeable

allow-window-handle

Whether to allow touchscreen swiping from GtkWindowHandle.

This will make dragging the window impossible.

Readable | Writeable

enabled

Whether the swipe tracker is enabled.

When it’s not enabled, no events will be processed. Usually widgets will want to expose this via a property.

Readable | Writeable

lower-overshoot

Whether to allow swiping past the first available snap point.

Readable | Writeable

reversed

Whether to reverse the swipe direction.

If the swipe tracker is horizontal, it can be used for supporting RTL text direction.

Readable | Writeable

swipeable

The widget the swipe tracker is attached to.

Readable | Writeable | Construct Only

upper-overshoot

Whether to allow swiping past the last available snap point.

Readable | Writeable

Orientable

orientation

The orientation of the orientable.

Readable | Writeable

Signals

begin-swipe

This signal is emitted right before a swipe will be started, after the drag threshold has been passed.

end-swipe

This signal is emitted as soon as the gesture has stopped.

The user is expected to animate the deceleration from the current progress value to @to with an animation using @velocity as the initial velocity, provided in pixels per second. SpringAnimation is usually a good fit for this.

prepare

This signal is emitted when a possible swipe is detected.

The @direction value can be used to restrict the swipe to a certain direction.

update-swipe

This signal is emitted every time the progress value changes.

Implements

[trait@glib::ObjectExt], gtk::prelude::OrientableExt

GLib type: GObject with reference counted clone semantics.

Implementations

impl SwipeTracker

pub fn new(swipeable: &impl IsA<Swipeable>) -> SwipeTracker

Creates a new SwipeTracker for @widget.

swipeable

a widget to add the tracker on

Returns

the newly created SwipeTracker

pub fn builder() -> SwipeTrackerBuilder

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

This method returns an instance of SwipeTrackerBuilder which can be used to create SwipeTracker objects.

pub fn allows_long_swipes(&self) -> bool

Gets whether to allow swiping for more than one snap point at a time.

Returns

whether long swipes are allowed

pub fn allows_mouse_drag(&self) -> bool

Gets whether @self can be dragged with mouse pointer.

Returns

whether mouse dragging is allowed

pub fn allows_window_handle(&self) -> bool

Available on crate feature v1_5 only.

Gets whether to allow touchscreen swiping from GtkWindowHandle.

Returns

whether swiping from window handles is allowed

pub fn is_enabled(&self) -> bool

Gets whether @self is enabled.

Returns

whether @self is enabled

pub fn is_lower_overshoot(&self) -> bool

Available on crate feature v1_4 only.

Gets whether to allow swiping past the first available snap point.

Returns

whether to allow swiping past the first available snap point

pub fn is_reversed(&self) -> bool

Gets whether @self is reversing the swipe direction.

Returns

whether the direction is reversed

pub fn swipeable(&self) -> Swipeable

Get the widget @self is attached to.

Returns

the swipeable widget

pub fn is_upper_overshoot(&self) -> bool

Available on crate feature v1_4 only.

Gets whether to allow swiping past the last available snap point.

Returns

whether to allow swiping past the last available snap point

pub fn set_allow_long_swipes(&self, allow_long_swipes: bool)

Sets whether to allow swiping for more than one snap point at a time.

If the value is FALSE, each swipe can only move to the adjacent snap points.

allow_long_swipes

whether to allow long swipes

pub fn set_allow_mouse_drag(&self, allow_mouse_drag: bool)

Sets whether @self can be dragged with mouse pointer.

allow_mouse_drag

whether to allow mouse dragging

pub fn set_allow_window_handle(&self, allow_window_handle: bool)

Available on crate feature v1_5 only.

Sets whether to allow touchscreen swiping from GtkWindowHandle.

Setting it to TRUE will make dragging the window impossible.

allow_window_handle

whether to allow swiping from window handles

pub fn set_enabled(&self, enabled: bool)

Sets whether @self is enabled.

When it’s not enabled, no events will be processed. Usually widgets will want to expose this via a property.

enabled

whether @self is enabled

pub fn set_lower_overshoot(&self, overshoot: bool)

Available on crate feature v1_4 only.

Sets whether to allow swiping past the first available snap point.

overshoot

whether to allow swiping past the first available snap point

pub fn set_reversed(&self, reversed: bool)

Sets whether to reverse the swipe direction.

If the swipe tracker is horizontal, it can be used for supporting RTL text direction.

reversed

whether to reverse the swipe direction

pub fn set_upper_overshoot(&self, overshoot: bool)

Available on crate feature v1_4 only.

Sets whether to allow swiping past the last available snap point.

overshoot

whether to allow swiping past the last available snap point

pub fn shift_position(&self, delta: f64)

Moves the current progress value by @delta.

This can be used to adjust the current position if snap points move during the gesture.

delta

the position delta

pub fn connect_begin_swipe<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

This signal is emitted right before a swipe will be started, after the drag threshold has been passed.

pub fn connect_end_swipe<F: Fn(&Self, f64, f64) + 'static>( &self, f: F, ) -> SignalHandlerId

This signal is emitted as soon as the gesture has stopped.

The user is expected to animate the deceleration from the current progress value to @to with an animation using @velocity as the initial velocity, provided in pixels per second. SpringAnimation is usually a good fit for this.

velocity

the velocity of the swipe

to

the progress value to animate to

pub fn connect_prepare<F: Fn(&Self, NavigationDirection) + 'static>( &self, f: F, ) -> SignalHandlerId

This signal is emitted when a possible swipe is detected.

The @direction value can be used to restrict the swipe to a certain direction.

direction

the direction of the swipe

pub fn connect_update_swipe<F: Fn(&Self, f64) + 'static>( &self, f: F, ) -> SignalHandlerId

This signal is emitted every time the progress value changes.

progress

the current animation progress value

pub fn connect_allow_long_swipes_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_allow_mouse_drag_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_allow_window_handle_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_5 only.

pub fn connect_enabled_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_lower_overshoot_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_4 only.

pub fn connect_reversed_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

pub fn connect_upper_overshoot_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

Available on crate feature v1_4 only.

Trait Implementations

impl Clone for SwipeTracker

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 SwipeTracker

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

Formats the value using the given formatter.

impl Default for SwipeTracker

fn default() -> Self

Returns the “default value” for a type.

impl HasParamSpec for SwipeTracker

type ParamSpec = ParamSpecObject

type SetValue = SwipeTracker

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

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

fn param_spec_builder() -> Self::BuilderFn

impl Hash for SwipeTracker

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 SwipeTracker

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 SwipeTracker

type Parent = Object

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

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 SwipeTracker

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 SwipeTracker

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for SwipeTracker

impl IsA<Orientable> for SwipeTracker