gtkmm
3.15.3
|
"Press and Hold" gesture. More...
#include <gtkmm/gesturelongpress.h>
Public Member Functions | |
virtual | ~GestureLongPress () |
GtkGestureLongPress* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkGestureLongPress* | gobj () const |
Provides access to the underlying C GObject. More... | |
GtkGestureLongPress* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More... | |
Glib::SignalProxy2< void, double, double > | signal_pressed () |
Glib::SignalProxy0< void > | signal_cancelled () |
![]() | |
virtual | ~GestureSingle () |
GtkGestureSingle* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkGestureSingle* | gobj () const |
Provides access to the underlying C GObject. More... | |
GtkGestureSingle* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More... | |
bool | get_touch_only () const |
Returns true if the gesture is only triggered by touch events. More... | |
void | set_touch_only (bool touch_only=true) |
If touch_only is true , gesture will only handle events of type Gdk::TOUCH_BEGIN, Gdk::TOUCH_UPDATE or Gdk::TOUCH_END. More... | |
bool | get_exclusive () const |
Gets whether a gesture is exclusive. More... | |
void | set_exclusive (bool exclusive=true) const |
Sets whether gesture is exclusive. More... | |
unsigned int | get_button () const |
Returns the button number gesture listens for, or 0 if gesture reacts to any button press. More... | |
void | set_button (unsigned int button=0) |
Sets the button number gesture listens to. More... | |
unsigned int | get_current_button () const |
Returns the button number currently interacting with gesture, or 0 if there is none. More... | |
GdkEventSequence* | get_current_sequence () |
Returns the event sequence currently interacting with gesture. More... | |
const GdkEventSequence* | get_current_sequence () const |
Returns the event sequence currently interacting with gesture. More... | |
Glib::PropertyProxy< bool > | property_touch_only () |
Whether the gesture handles only touch events. More... | |
Glib::PropertyProxy_ReadOnly < bool > | property_touch_only () const |
Whether the gesture handles only touch events. More... | |
Glib::PropertyProxy< bool > | property_exclusive () |
Whether the gesture is exclusive. More... | |
Glib::PropertyProxy_ReadOnly < bool > | property_exclusive () const |
Whether the gesture is exclusive. More... | |
Glib::PropertyProxy< unsigned int > | property_button () |
Button number to listen to. More... | |
Glib::PropertyProxy_ReadOnly < unsigned int > | property_button () const |
Button number to listen to. More... | |
![]() | |
virtual | ~Gesture () |
GtkGesture* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkGesture* | gobj () const |
Provides access to the underlying C GObject. More... | |
GtkGesture* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More... | |
Glib::RefPtr< Gdk::Device > | get_device () |
Returns the master Gdk::Device that is currently operating on gesture, or 0 if the gesture is not being interacted. More... | |
Glib::RefPtr< const Gdk::Device > | get_device () const |
Returns the master Gdk::Device that is currently operating on gesture, or 0 if the gesture is not being interacted. More... | |
bool | set_state (EventSequenceState state) |
Sets the state of all sequences that gesture is currently interacting with. More... | |
EventSequenceState | get_sequence_state (GdkEventSequence*sequence) const |
Returns the sequence state, as seen by gesture. More... | |
bool | set_sequence_state (GdkEventSequence*sequence, EventSequenceState state) |
Sets the state of sequence in gesture. More... | |
std::vector< const GdkEventSequence* > | get_sequences () const |
Returns the list of GdkEventSequences currently being interpreted. More... | |
GdkEventSequence* | get_last_updated_sequence () |
Returns the Gdk::EventSequence that was last updated on gesture. More... | |
const GdkEventSequence* | get_last_updated_sequence () const |
Returns the Gdk::EventSequence that was last updated on gesture. More... | |
bool | handles_sequence (GdkEventSequence*sequence) const |
Returns true if gesture is currently handling events corresponding to sequence. More... | |
const GdkEvent* | get_last_event (GdkEventSequence*sequence) const |
Returns the last event that was processed for sequence. More... | |
bool | get_point (GdkEventSequence*sequence, double& x, double& y) const |
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. More... | |
bool | get_bounding_box (Gdk::Rectangle& rect) const |
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. More... | |
bool | get_bounding_box_center (double& x, double& y) const |
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. More... | |
bool | is_active () const |
Returns true if the gesture is currently active. More... | |
bool | is_recognized () const |
Returns true if the gesture is currently recognized. More... | |
Glib::RefPtr< Gdk::Window > | get_window () |
Returns the user-defined window that receives the events handled by gesture. More... | |
Glib::RefPtr< const Gdk::Window > | get_window () const |
Returns the user-defined window that receives the events handled by gesture. More... | |
void | set_window (const Glib::RefPtr< Gdk::Window >& window) |
Sets a specific window to receive events about, so gesture will effectively handle only events targeting window, or a child of it. More... | |
void | unset_window () |
Undoes the effect of previous calls to set_window(), so the gesture will handle events targeting any Gdk::Window that pertains to Gtk::EventController::get_widget(). More... | |
void | group (const Glib::RefPtr< Gesture >& group_gesture) |
Adds gesture to the same group than group_gesture. More... | |
void | ungroup () |
Separates gesture into an isolated group. More... | |
std::vector< Glib::RefPtr < Gesture > > | get_group () |
Returns all gestures in the group of gesture. More... | |
std::vector< Glib::RefPtr < const Gesture > > | get_group () const |
Returns all gestures in the group of gesture. More... | |
bool | is_grouped_with (const Glib::RefPtr< Gesture >& other) const |
Returns true if both gestures pertain to the same group. More... | |
Glib::SignalProxy1< void, GdkEventSequence* > | signal_begin () |
Glib::SignalProxy1< void, GdkEventSequence* > | signal_end () |
Glib::SignalProxy1< void, GdkEventSequence* > | signal_update () |
Glib::SignalProxy1< void, GdkEventSequence* > | signal_cancel () |
Glib::SignalProxy2< void, GdkEventSequence *, EventSequenceState > | signal_sequence_state_changed () |
Glib::PropertyProxy_ReadOnly < unsigned int > | property_n_points () const |
Number of points needed to trigger the gesture. More... | |
Glib::PropertyProxy < Glib::RefPtr< Gdk::Window > > | property_window () |
GdkWindow to receive events about. More... | |
Glib::PropertyProxy_ReadOnly < Glib::RefPtr< Gdk::Window > > | property_window () const |
GdkWindow to receive events about. More... | |
![]() | |
virtual | ~EventController () |
GtkEventController* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkEventController* | gobj () const |
Provides access to the underlying C GObject. More... | |
GtkEventController* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More... | |
Widget* | get_widget () |
Returns the Gtk::Widget this controller relates to. More... | |
const Widget* | get_widget () const |
Returns the Gtk::Widget this controller relates to. More... | |
bool | handle_event (const GdkEvent* event) |
Feeds an events into controller, so it can be interpreted and the controller actions triggered. More... | |
void | reset () |
Resets the controller to a clean state. More... | |
PropagationPhase | get_propagation_phase () const |
Gets the propagation phase at which controller handles events. More... | |
void | set_propagation_phase (PropagationPhase phase) |
Sets the propagation phase at which a controller handles events. More... | |
Glib::PropertyProxy_ReadOnly < Widget* > | property_widget () const |
Widget the gesture relates to. More... | |
Glib::PropertyProxy < PropagationPhase > | property_propagation_phase () |
Propagation phase at which this controller is run. More... | |
Glib::PropertyProxy_ReadOnly < PropagationPhase > | property_propagation_phase () const |
Propagation phase at which this controller is run. More... | |
Static Public Member Functions | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
static Glib::RefPtr < GestureLongPress > | create (Widget& widget) |
Creates a Gesture that recognizes long presses. More... | |
![]() | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
![]() | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
![]() | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
Protected Member Functions | |
GestureLongPress () | |
There is no create() method that corresponds to this constructor, because this constructor shall only be used by derived classes. More... | |
GestureLongPress (Widget& widget) | |
Constructs a Gesture that recognizes long presses. More... | |
![]() | |
GestureSingle () | |
There is no create() method that corresponds to this constructor, because only derived classes shall be created. More... | |
![]() | |
Gesture () | |
There is no create() method that corresponds to this constructor, because only derived classes shall be created. More... | |
![]() | |
EventController () | |
There is no create() method that corresponds to this constructor, because only derived classes shall be created. More... | |
Related Functions | |
(Note that these are not member functions.) | |
Glib::RefPtr < Gtk::GestureLongPress > | wrap (GtkGestureLongPress* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
![]() | |
Glib::RefPtr< Gtk::GestureSingle > | wrap (GtkGestureSingle* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
![]() | |
Glib::RefPtr< Gtk::Gesture > | wrap (GtkGesture* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
![]() | |
Glib::RefPtr < Gtk::EventController > | wrap (GtkEventController* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
"Press and Hold" gesture.
This is a Gesture implementation able to recognize long presses, triggering signal_pressed() after the timeout is exceeded.
If the touchpoint is lifted before the timeout passes, or if it drifts too far of the initial press point, signal_cancelled() will be emitted.
|
virtual |
|
protected |
There is no create() method that corresponds to this constructor, because this constructor shall only be used by derived classes.
|
explicitprotected |
Constructs a Gesture that recognizes long presses.
|
static |
Creates a Gesture that recognizes long presses.
widget | Widget the gesture relates to. |
|
static |
Get the GType for this class, for use with the underlying GObject type system.
|
inline |
Provides access to the underlying C GObject.
|
inline |
Provides access to the underlying C GObject.
GtkGestureLongPress* Gtk::GestureLongPress::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
Glib::SignalProxy0< void > Gtk::GestureLongPress::signal_cancelled | ( | ) |
void on_my_cancelled()
This signal is emitted whenever a press moved too far, or was released before Gtk::GestureLongPress::property_pressed() happened.
Glib::SignalProxy2< void,double,double > Gtk::GestureLongPress::signal_pressed | ( | ) |
void on_my_pressed(double x, double y)
This signal is emitted whenever a press goes unmoved/unreleased longer than what the GTK+ defaults tell.
x | The X coordinate where the press happened, relative to the widget allocation. |
y | The Y coordinate where the press happened, relative to the widget allocation. |
|
related |
A Glib::wrap() method for this object.
object | The C instance. |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |