Class
GtkGestureRotate
Description [src]
final class Gtk.GestureRotate : Gtk.Gesture
{
/* No available fields */
}
GtkGestureRotate
is a GtkGesture
implementation able to recognize
2-finger rotations, whenever the angle between both handled sequences
changes, the GtkGestureRotate::angle-changed
signal is emitted.
Constructors
gtk_gesture_rotate_new
Returns a newly created GtkGesture
that recognizes 2-touch
rotation gestures.
since: 3.14
Instance methods
gtk_gesture_rotate_get_angle_delta
If gesture
is active, this function returns the angle difference
in radians since the gesture was first recognized. If gesture
is
not active, 0 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.GestureRotate::angle-changed
This signal is emitted when the angle between both tracked points 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.