Class
GtkGestureZoom
Description [src]
final class Gtk.GestureZoom : Gtk.Gesture
{
/* No available fields */
}GtkGestureZoom is a GtkGesture implementation able to recognize
pinch/zoom gestures, whenever the distance between both tracked
sequences changes, the GtkGestureZoom::scale-changed signal is
emitted to report the scale factor.
Constructors
gtk_gesture_zoom_new
Returns a newly created GtkGesture that recognizes zoom
in/out gestures (usually known as pinch/zoom).
since: 3.14
Instance methods
gtk_gesture_zoom_get_scale_delta
If gesture is active, this function returns the zooming difference
since the gesture was recognized (hence the starting point is
considered 1:1). If gesture is not active, 1 is returned.
since: 3.14
Methods inherited from GtkGesture (19)
gtk_gesture_get_bounding_box
If there are touch sequences being currently handled by gesture,
this function returns TRUE and fills in rect with the bounding
box containing all active touches. Otherwise, FALSE will be returned.
since: 3.14
gtk_gesture_get_bounding_box_center
If there are touch sequences being currently handled by gesture,
this function returns TRUE and fills in x and y with the center
of the bounding box containing all active touches. Otherwise, FALSE
will be returned.
since: 3.14
gtk_gesture_get_device
Returns the master GdkDevice that is currently operating
on gesture, or NULL if the gesture is not being interacted.
since: 3.14
gtk_gesture_get_group
Returns all gestures in the group of gesture.
since: 3.14
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.
since: 3.14
gtk_gesture_get_point
If sequence is currently being interpreted by gesture, this
function returns TRUE and fills in x and y with the last coordinates
stored for that event sequence. The coordinates are always relative to the
widget allocation.
since: 3.14
gtk_gesture_get_sequence_state
Returns the sequence state, as seen by gesture.
since: 3.14
gtk_gesture_get_sequences
Returns the list of GdkEventSequences currently being interpreted
by gesture.
since: 3.14
gtk_gesture_get_window
Returns the user-defined window that receives the events
handled by gesture. See gtk_gesture_set_window() for more information.
since: 3.14
gtk_gesture_group
Adds gesture to the same group than group_gesture. Gestures
are by default isolated in their own groups.
since: 3.14
gtk_gesture_handles_sequence
Returns TRUE if gesture is currently handling events corresponding to
sequence.
since: 3.14
gtk_gesture_is_active
Returns TRUE if the gesture is currently active.
A gesture is active meanwhile there are touch sequences
interacting with it.
since: 3.14
gtk_gesture_is_grouped_with
Returns TRUE if both gestures pertain to the same group.
since: 3.14
gtk_gesture_is_recognized
Returns TRUE if the gesture is currently recognized.
A gesture is recognized if there are as many interacting
touch sequences as required by gesture, and GtkGesture::check
returned TRUE for the sequences being currently interpreted.
since: 3.14
gtk_gesture_set_sequence_state
Sets the state of sequence in gesture. Sequences start
in state #GTK_EVENT_SEQUENCE_NONE, and whenever they change
state, they can never go back to that state. Likewise,
sequences in state #GTK_EVENT_SEQUENCE_DENIED cannot turn
back to a not denied state. With these rules, the lifetime
of an event sequence is constrained to the next four:.
since: 3.14
gtk_gesture_set_state
Sets the state of all sequences that gesture is currently
interacting with. See gtk_gesture_set_sequence_state()
for more details on sequence states.
since: 3.14
gtk_gesture_set_window
Sets a specific window to receive events about, so gesture
will effectively handle only events targeting window, or
a child of it. window must pertain to gtk_event_controller_get_widget().
since: 3.14
gtk_gesture_ungroup
Separates gesture into an isolated group.
since: 3.14
Methods inherited from GtkEventController (5)
gtk_event_controller_get_propagation_phase
Gets the propagation phase at which controller handles events.
since: 3.14
gtk_event_controller_get_widget
Returns the GtkWidget this controller relates to.
since: 3.14
gtk_event_controller_handle_event
Feeds an events into controller, so it can be interpreted
and the controller actions triggered.
since: 3.14
gtk_event_controller_reset
Resets the controller to a clean state. Every interaction
the controller did through GtkEventController::handle-event
will be dropped at this point.
since: 3.14
gtk_event_controller_set_propagation_phase
Sets the propagation phase at which a controller handles events.
since: 3.14
Properties
Properties inherited from GtkGesture (2)
Gtk.Gesture:n-points
The number of touch points that trigger recognition on this gesture,.
since: 3.14
Gtk.Gesture:window
If non-NULL, the gesture will only listen for events that happen on
this GdkWindow, or a child of it.
since: 3.14
Properties inherited from GtkEventController (2)
Gtk.EventController:propagation-phase
The propagation phase at which this controller will handle events.
since: 3.14
Gtk.EventController:widget
The widget receiving the GdkEvents that the controller will handle.
since: 3.14
Signals
Gtk.GestureZoom::scale-changed
This signal is emitted whenever the distance between both tracked sequences changes.
since: 3.14
Signals inherited from GtkGesture (5)
GtkGesture::begin
This signal is emitted when the gesture is recognized. This means the
number of touch sequences matches GtkGesture:n-points, and the GtkGesture::check
handler(s) returned TRUE.
since: 3.14
GtkGesture::cancel
This signal is emitted whenever a sequence is cancelled. This usually
happens on active touches when gtk_event_controller_reset() is called
on gesture (manually, due to grabs…), or the individual sequence
was claimed by parent widgets’ controllers (see gtk_gesture_set_sequence_state()).
since: 3.14
GtkGesture::end
This signal is emitted when gesture either stopped recognizing the event
sequences as something to be handled (the GtkGesture::check handler returned
FALSE), or the number of touch sequences became higher or lower than
GtkGesture:n-points.
since: 3.14
GtkGesture::sequence-state-changed
This signal is emitted whenever a sequence state changes. See
gtk_gesture_set_sequence_state() to know more about the expectable
sequence lifetimes.
since: 3.14
GtkGesture::update
This signal is emitted whenever an event is handled while the gesture is
recognized. sequence is guaranteed to pertain to the set of active touches.
since: 3.14
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.