Class

Gtk.GestureLongPress

Description [src]

final class Gtk.GestureLongPress : Gtk.GestureSingle {
  /* No available fields */
}

GtkGestureLongPress is a GtkGesture for long presses.

This gesture is also known as “Press and Hold”.

When the timeout is exceeded, the gesture is triggering the GtkGestureLongPress::pressed signal.

If the touchpoint is lifted before the timeout passes, or if it drifts too far of the initial press point, the GtkGestureLongPress::cancelled signal will be emitted.

How long the timeout is before the ::pressed signal gets emitted is determined by the GtkSettings:gtk-long-press-time setting. It can be modified by the GtkGestureLongPress:delay-factor property.

Hierarchy

hierarchy this GtkGestureLongPress ancestor_0 GtkGestureSingle ancestor_0--this ancestor_1 GtkGesture ancestor_1--ancestor_0 ancestor_2 GtkEventController ancestor_2--ancestor_1

Constructors

gtk_gesture_long_press_new

Returns a newly created GtkGesture that recognizes long presses.

Instance methods

gtk_gesture_long_press_get_delay_factor

Returns the delay factor.

gtk_gesture_long_press_set_delay_factor

Applies the given delay factor.

Methods inherited from GtkGestureSingle (8)
gtk_gesture_single_get_button

Returns the button number gesture listens for.

gtk_gesture_single_get_current_button

Returns the button number currently interacting with gesture, or 0 if there is none.

gtk_gesture_single_get_current_sequence

Returns the event sequence currently interacting with gesture.

gtk_gesture_single_get_exclusive

Gets whether a gesture is exclusive.

gtk_gesture_single_get_touch_only

Returns TRUE if the gesture is only triggered by touch events.

gtk_gesture_single_set_button

Sets the button number gesture listens to.

gtk_gesture_single_set_exclusive

Sets whether gesture is exclusive.

gtk_gesture_single_set_touch_only

Sets whether to handle only touch events.

Methods inherited from GtkGesture (17)
gtk_gesture_get_bounding_box

If there are touch sequences being currently handled by gesture, returns TRUE and fills in rect with the bounding box containing all active touches.

gtk_gesture_get_bounding_box_center

If there are touch sequences being currently handled by gesture, returns TRUE and fills in x and y with the center of the bounding box containing all active touches.

gtk_gesture_get_device

Returns the logical GdkDevice that is currently operating on gesture.

gtk_gesture_get_group

Returns all gestures in the group of gesture

gtk_gesture_get_last_event

Returns the last event that was processed for sequence.

gtk_gesture_get_last_updated_sequence

Returns the GdkEventSequence that was last updated on gesture.

gtk_gesture_get_point

If sequence is currently being interpreted by gesture, returns TRUE and fills in x and y with the last coordinates stored for that event sequence.

gtk_gesture_get_sequence_state

Returns the sequence state, as seen by gesture.

gtk_gesture_get_sequences

Returns the list of GdkEventSequences currently being interpreted by gesture.

gtk_gesture_group

Adds gesture to the same group than group_gesture.

gtk_gesture_handles_sequence

Returns TRUE if gesture is currently handling events corresponding to sequence.

gtk_gesture_is_active

Returns TRUE if the gesture is currently active.

gtk_gesture_is_grouped_with

Returns TRUE if both gestures pertain to the same group.

gtk_gesture_is_recognized

Returns TRUE if the gesture is currently recognized.

gtk_gesture_set_sequence_state

Sets the state of sequence in gesture.

gtk_gesture_set_state

Sets the state of all sequences that gesture is currently interacting with.

gtk_gesture_ungroup

Separates gesture into an isolated group.

Methods inherited from GtkEventController (12)
gtk_event_controller_get_current_event

Returns the event that is currently being handled by the controller, and NULL at other times.

gtk_event_controller_get_current_event_device

Returns the device of the event that is currently being handled by the controller, and NULL otherwise.

gtk_event_controller_get_current_event_state

Returns the modifier state of the event that is currently being handled by the controller, and 0 otherwise.

gtk_event_controller_get_current_event_time

Returns the timestamp of the event that is currently being handled by the controller, and 0 otherwise.

gtk_event_controller_get_name

Gets the name of controller.

gtk_event_controller_get_propagation_limit

Gets the propagation limit of the event controller.

gtk_event_controller_get_propagation_phase

Gets the propagation phase at which controller handles events.

gtk_event_controller_get_widget

Returns the GtkWidget this controller relates to.

gtk_event_controller_reset

Resets the controller to a clean state.

gtk_event_controller_set_name

Sets a name on the controller that can be used for debugging.

gtk_event_controller_set_propagation_limit

Sets the event propagation limit on the event controller.

gtk_event_controller_set_propagation_phase

Sets the propagation phase at which a controller handles events.

Properties

Gtk.GestureLongPress:delay-factor

Factor by which to modify the default timeout.

Properties inherited from GtkGestureSingle (3)
Gtk.GestureSingle:button

Mouse button number to listen to, or 0 to listen for any button.

Gtk.GestureSingle:exclusive

Whether the gesture is exclusive.

Gtk.GestureSingle:touch-only

Whether the gesture handles only touch events.

Properties inherited from GtkGesture (1)
Gtk.Gesture:n-points

The number of touch points that trigger recognition on this gesture.

Properties inherited from GtkEventController (4)
Gtk.EventController:name

The name for this controller, typically used for debugging purposes.

Gtk.EventController:propagation-limit

The limit for which events this controller will handle.

Gtk.EventController:propagation-phase

The propagation phase at which this controller will handle events.

Gtk.EventController:widget

The widget receiving the GdkEvents that the controller will handle.

Signals

Gtk.GestureLongPress::cancelled

Emitted whenever a press moved too far, or was released before GtkGestureLongPress::pressed happened.

Gtk.GestureLongPress::pressed

Emitted whenever a press goes unmoved/unreleased longer than what the GTK defaults tell.

Signals inherited from GtkGesture (5)
Gtk.Gesture::begin

Emitted when the gesture is recognized.

Gtk.Gesture::cancel

Emitted whenever a sequence is cancelled.

Gtk.Gesture::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 GtkGesture:n-points.

Gtk.Gesture::sequence-state-changed

Emitted whenever a sequence state changes.

Gtk.Gesture::update

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

Class structure

struct GtkGestureLongPressClass {
  /* no available fields */
}