GI.Handy.Objects.SwipeTracker

Swipe tracker used in [classcarousel] and [classleaflet].

The HdySwipeTracker 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 [propertyswipeTracker:enabled] property. If they expect to use horizontal orientation, [propertyswipeTracker:reversed] property can be used for supporting RTL text direction.

Since: 1.0

Exported types

newtype SwipeTracker

Memory-managed wrapper type.

Constructors

SwipeTracker (ManagedPtr SwipeTracker)

Instances

Eq SwipeTracker

Defined in GI.Handy.Objects.SwipeTracker

Methods

(==) :: SwipeTracker -> SwipeTracker -> Bool

(/=) :: SwipeTracker -> SwipeTracker -> Bool

GObject SwipeTracker

Defined in GI.Handy.Objects.SwipeTracker

ManagedPtrNewtype SwipeTracker

Defined in GI.Handy.Objects.SwipeTracker

Methods

toManagedPtr :: SwipeTracker -> ManagedPtr SwipeTracker

TypedObject SwipeTracker

Defined in GI.Handy.Objects.SwipeTracker

Methods

glibType :: IO GType

HasParentTypes SwipeTracker

Defined in GI.Handy.Objects.SwipeTracker

IsGValue (Maybe SwipeTracker)

Convert SwipeTracker to and from GValue. See toGValue and fromGValue.

Defined in GI.Handy.Objects.SwipeTracker

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe SwipeTracker -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe SwipeTracker)

type ParentTypes SwipeTracker

Defined in GI.Handy.Objects.SwipeTracker

type ParentTypes SwipeTracker = '[Object, Orientable]

class (GObject o, IsDescendantOf SwipeTracker o) => IsSwipeTracker o

Type class for types which can be safely cast to SwipeTracker, for instance with toSwipeTracker.

Instances

(GObject o, IsDescendantOf SwipeTracker o) => IsSwipeTracker o

Defined in GI.Handy.Objects.SwipeTracker

toSwipeTracker :: (MonadIO m, IsSwipeTracker o) => o -> m SwipeTracker

Cast to SwipeTracker, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

bindProperty, bindPropertyFull, forceFloating, freezeNotify, getv, isFloating, notify, notifyByPspec, ref, refSink, runDispose, shiftPosition, stealData, stealQdata, thawNotify, unref, watchClosure.

Getters

getAllowLongSwipes, getAllowMouseDrag, getData, getEnabled, getOrientation, getProperty, getQdata, getReversed, getSwipeable.

Setters

setAllowLongSwipes, setAllowMouseDrag, setData, setDataFull, setEnabled, setOrientation, setProperty, setReversed.

getAllowLongSwipes

swipeTrackerGetAllowLongSwipes

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> m Bool

Returns: whether long swipes are allowed

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.

Since: 1.2

getAllowMouseDrag

swipeTrackerGetAllowMouseDrag

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> m Bool

Returns: TRUE is mouse dragging is allowed

Get whether self can be dragged with mouse pointer.

Since: 1.0

getEnabled

swipeTrackerGetEnabled

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> m Bool

Returns: TRUE if self is enabled

Get whether self is enabled.

Since: 1.0

getReversed

swipeTrackerGetReversed

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> m Bool

Returns: TRUE is the direction is reversed

Get whether self is reversing the swipe direction.

Since: 1.0

getSwipeable

swipeTrackerGetSwipeable

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> m Swipeable

Returns: the swipeable widget

Get self's swipeable widget.

Since: 1.0

new

swipeTrackerNew

Arguments

:: (HasCallStack, MonadIO m, IsSwipeable a)

=> a

swipeable: a swipeable to add the tracker on

-> m SwipeTracker

Returns: the newly created HdySwipeTracker

Creates a new HdySwipeTracker object on widget.

Since: 1.0

setAllowLongSwipes

swipeTrackerSetAllowLongSwipes

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> Bool

allowLongSwipes: whether to allow long swipes

-> m ()

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.

Since: 1.2

setAllowMouseDrag

swipeTrackerSetAllowMouseDrag

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> Bool

allowMouseDrag: whether to allow mouse dragging

-> m ()

Set whether self can be dragged with mouse pointer.

This should usually be FALSE.

Since: 1.0

setEnabled

swipeTrackerSetEnabled

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> Bool

enabled: whether to enable to swipe tracker

-> m ()

Set whether self is enabled.

Since: 1.0

setReversed

swipeTrackerSetReversed

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> Bool

reversed: whether to reverse the swipe direction

-> m ()

Set whether to reverse the swipe direction.

If self is horizontal, can be used for supporting RTL text direction.

Since: 1.0

shiftPosition

swipeTrackerShiftPosition

Arguments

:: (HasCallStack, MonadIO m, IsSwipeTracker a)

=> a

self: a swipe tracker

-> Double

delta: the position delta

-> m ()

Move the current progress value by delta.

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

Since: 1.0

Properties

allowLongSwipes

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.

Since: 1.2

constructSwipeTrackerAllowLongSwipes :: (IsSwipeTracker o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “allow-long-swipes” property. This is rarely needed directly, but it is used by new.

getSwipeTrackerAllowLongSwipes :: (MonadIO m, IsSwipeTracker o) => o -> m Bool

Get the value of the “allow-long-swipes” property. When overloading is enabled, this is equivalent to

get swipeTracker #allowLongSwipes

setSwipeTrackerAllowLongSwipes :: (MonadIO m, IsSwipeTracker o) => o -> Bool -> m ()

Set the value of the “allow-long-swipes” property. When overloading is enabled, this is equivalent to

set swipeTracker [ #allowLongSwipes := value ]

allowMouseDrag

Whether to allow dragging with mouse pointer.

This should usually be FALSE.

Since: 1.0

constructSwipeTrackerAllowMouseDrag :: (IsSwipeTracker o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “allow-mouse-drag” property. This is rarely needed directly, but it is used by new.

getSwipeTrackerAllowMouseDrag :: (MonadIO m, IsSwipeTracker o) => o -> m Bool

Get the value of the “allow-mouse-drag” property. When overloading is enabled, this is equivalent to

get swipeTracker #allowMouseDrag

setSwipeTrackerAllowMouseDrag :: (MonadIO m, IsSwipeTracker o) => o -> Bool -> m ()

Set the value of the “allow-mouse-drag” property. When overloading is enabled, this is equivalent to

set swipeTracker [ #allowMouseDrag := value ]

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.

Since: 1.0

constructSwipeTrackerEnabled :: (IsSwipeTracker o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “enabled” property. This is rarely needed directly, but it is used by new.

getSwipeTrackerEnabled :: (MonadIO m, IsSwipeTracker o) => o -> m Bool

Get the value of the “enabled” property. When overloading is enabled, this is equivalent to

get swipeTracker #enabled

setSwipeTrackerEnabled :: (MonadIO m, IsSwipeTracker o) => o -> Bool -> m ()

Set the value of the “enabled” property. When overloading is enabled, this is equivalent to

set swipeTracker [ #enabled := value ]

reversed

Whether to reverse the swipe direction.

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

Since: 1.0

constructSwipeTrackerReversed :: (IsSwipeTracker o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “reversed” property. This is rarely needed directly, but it is used by new.

getSwipeTrackerReversed :: (MonadIO m, IsSwipeTracker o) => o -> m Bool

Get the value of the “reversed” property. When overloading is enabled, this is equivalent to

get swipeTracker #reversed

setSwipeTrackerReversed :: (MonadIO m, IsSwipeTracker o) => o -> Bool -> m ()

Set the value of the “reversed” property. When overloading is enabled, this is equivalent to

set swipeTracker [ #reversed := value ]

swipeable

The widget the swipe tracker is attached to. Must not be NULL.

Since: 1.0

constructSwipeTrackerSwipeable :: (IsSwipeTracker o, MonadIO m, IsSwipeable a) => a -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “swipeable” property. This is rarely needed directly, but it is used by new.

getSwipeTrackerSwipeable :: (MonadIO m, IsSwipeTracker o) => o -> m Swipeable

Get the value of the “swipeable” property. When overloading is enabled, this is equivalent to

get swipeTracker #swipeable

Signals

beginSwipe

type SwipeTrackerBeginSwipeCallback

Arguments

 = NavigationDirection

direction: the direction of the swipe

-> Bool

direct: TRUE if the swipe is directly triggered by a gesture, FALSE if it's triggered via a [classswipeGroup]

-> IO ()

This signal is emitted when a possible swipe is detected.

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

Since: 1.0

afterSwipeTrackerBeginSwipe :: (IsSwipeTracker a, MonadIO m) => a -> ((?self :: a) => SwipeTrackerBeginSwipeCallback) -> m SignalHandlerId

Connect a signal handler for the beginSwipe signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after swipeTracker #beginSwipe callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onSwipeTrackerBeginSwipe :: (IsSwipeTracker a, MonadIO m) => a -> ((?self :: a) => SwipeTrackerBeginSwipeCallback) -> m SignalHandlerId

Connect a signal handler for the beginSwipe signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on swipeTracker #beginSwipe callback

endSwipe

type SwipeTrackerEndSwipeCallback

Arguments

 = Int64

duration: snap-back animation duration, in milliseconds

-> Double

to: the progress value to animate to

-> IO ()

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

Since: 1.0

afterSwipeTrackerEndSwipe :: (IsSwipeTracker a, MonadIO m) => a -> ((?self :: a) => SwipeTrackerEndSwipeCallback) -> m SignalHandlerId

Connect a signal handler for the endSwipe signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after swipeTracker #endSwipe callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onSwipeTrackerEndSwipe :: (IsSwipeTracker a, MonadIO m) => a -> ((?self :: a) => SwipeTrackerEndSwipeCallback) -> m SignalHandlerId

Connect a signal handler for the endSwipe signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on swipeTracker #endSwipe callback

updateSwipe

type SwipeTrackerUpdateSwipeCallback

Arguments

 = Double

progress: the current animation progress value

-> IO ()

This signal is emitted every time the progress value changes.

Since: 1.0

afterSwipeTrackerUpdateSwipe :: (IsSwipeTracker a, MonadIO m) => a -> ((?self :: a) => SwipeTrackerUpdateSwipeCallback) -> m SignalHandlerId

Connect a signal handler for the updateSwipe signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after swipeTracker #updateSwipe callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onSwipeTrackerUpdateSwipe :: (IsSwipeTracker a, MonadIO m) => a -> ((?self :: a) => SwipeTrackerUpdateSwipeCallback) -> m SignalHandlerId

Connect a signal handler for the updateSwipe signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on swipeTracker #updateSwipe callback