| Top | |
|
|
|
| gboolean | ctk_gesture_single_get_exclusive () |
| void | ctk_gesture_single_set_exclusive () |
| gboolean | ctk_gesture_single_get_touch_only () |
| void | ctk_gesture_single_set_touch_only () |
| guint | ctk_gesture_single_get_button () |
| void | ctk_gesture_single_set_button () |
| guint | ctk_gesture_single_get_current_button () |
| CdkEventSequence * | ctk_gesture_single_get_current_sequence () |
| guint | button | Read / Write |
| gboolean | exclusive | Read / Write |
| gboolean | touch-only | Read / Write |
GObject
╰── CtkEventController
╰── CtkGesture
╰── CtkGestureSingle
├── CtkGestureDrag
├── CtkGestureLongPress
├── CtkGestureMultiPress
├── CtkGestureStylus
╰── CtkGestureSwipe
CtkGestureSingle is a subclass of CtkGesture, optimized (although
not restricted) for dealing with mouse and single-touch gestures. Under
interaction, these gestures stick to the first interacting sequence, which
is accessible through ctk_gesture_single_get_current_sequence() while the
gesture is being interacted with.
By default gestures react to both CDK_BUTTON_PRIMARY and touch
events, ctk_gesture_single_set_touch_only() can be used to change the
touch behavior. Callers may also specify a different mouse button number
to interact with through ctk_gesture_single_set_button(), or react to any
mouse button by setting 0. While the gesture is active, the button being
currently pressed can be known through ctk_gesture_single_get_current_button().
gboolean
ctk_gesture_single_get_exclusive (CtkGestureSingle *gesture);
Gets whether a gesture is exclusive. For more information, see
ctk_gesture_single_set_exclusive().
Since: 3.14
void ctk_gesture_single_set_exclusive (CtkGestureSingle *gesture,gboolean exclusive);
Sets whether gesture
is exclusive. An exclusive gesture will
only handle pointer and "pointer emulated" touch events, so at
any given time, there is only one sequence able to interact with
those.
Since: 3.14
gboolean
ctk_gesture_single_get_touch_only (CtkGestureSingle *gesture);
Returns TRUE if the gesture is only triggered by touch events.
Since: 3.14
void ctk_gesture_single_set_touch_only (CtkGestureSingle *gesture,gboolean touch_only);
If touch_only
is TRUE, gesture
will only handle events of type
CDK_TOUCH_BEGIN, CDK_TOUCH_UPDATE or CDK_TOUCH_END. If FALSE,
mouse events will be handled too.
Since: 3.14
guint
ctk_gesture_single_get_button (CtkGestureSingle *gesture);
Returns the button number gesture
listens for, or 0 if gesture
reacts to any button press.
Since: 3.14
void ctk_gesture_single_set_button (CtkGestureSingle *gesture,guint button);
Sets the button number gesture
listens to. If non-0, every
button press from a different button number will be ignored.
Touch events implicitly match with button 1.
Since: 3.14
guint
ctk_gesture_single_get_current_button (CtkGestureSingle *gesture);
Returns the button number currently interacting with gesture
, or 0 if there
is none.
Since: 3.14
CdkEventSequence *
ctk_gesture_single_get_current_sequence
(CtkGestureSingle *gesture);
Returns the event sequence currently interacting with gesture
.
This is only meaningful if ctk_gesture_is_active() returns TRUE.
Since: 3.14
“button” property “button” guint
Mouse button number to listen to, or 0 to listen for any button.
Owner: CtkGestureSingle
Flags: Read / Write
Default value: 1
Since: 3.14
“exclusive” property “exclusive” gboolean
Whether the gesture is exclusive. Exclusive gestures only listen to pointer and pointer emulated events.
Owner: CtkGestureSingle
Flags: Read / Write
Default value: FALSE
Since: 3.14
“touch-only” property “touch-only” gboolean
Whether the gesture handles only touch events.
Owner: CtkGestureSingle
Flags: Read / Write
Default value: FALSE
Since: 3.14