Enumeration
GdkEventMask
Description [src]
A set of bit-flags to indicate which events a window is to receive.
Most of these masks map onto one or more of the GdkEventType
event types above.
See the [input handling overview][chap-input-handling] for details of [event masks][event-masks] and [event propagation][event-propagation].
GDK_POINTER_MOTION_HINT_MASK
is deprecated. It is a special mask
to reduce the number of GDK_MOTION_NOTIFY
events received. When using
GDK_POINTER_MOTION_HINT_MASK
, fewer GDK_MOTION_NOTIFY
events will
be sent, some of which are marked as a hint (the is_hint member is
TRUE
). To receive more motion events after a motion hint event,
the application needs to asks for more, by calling gdk_event_request_motions().
Since GTK 3.8, motion events are already compressed by default, independent of this mechanism. This compression can be disabled with gdk_window_set_event_compression(). See the documentation of that function for details.
If GDK_TOUCH_MASK
is enabled, the window will receive touch events
from touch-enabled devices. Those will come as sequences of GdkEventTouch
with type GDK_TOUCH_UPDATE
, enclosed by two events with
type GDK_TOUCH_BEGIN
and GDK_TOUCH_END
(or GDK_TOUCH_CANCEL
).
gdk_event_get_event_sequence()
returns the event sequence for these
events, so different sequences may be distinguished.
Members
Name | Description |
---|---|
GDK_EXPOSURE_MASK |
Receive expose events. |
GDK_POINTER_MOTION_MASK |
Receive all pointer motion events. |
GDK_POINTER_MOTION_HINT_MASK |
Deprecated. see the explanation above. |
GDK_BUTTON_MOTION_MASK |
Receive pointer motion events while any button is pressed. |
GDK_BUTTON1_MOTION_MASK |
Receive pointer motion events while 1 button is pressed. |
GDK_BUTTON2_MOTION_MASK |
Receive pointer motion events while 2 button is pressed. |
GDK_BUTTON3_MOTION_MASK |
Receive pointer motion events while 3 button is pressed. |
GDK_BUTTON_PRESS_MASK |
Receive button press events. |
GDK_BUTTON_RELEASE_MASK |
Receive button release events. |
GDK_KEY_PRESS_MASK |
Receive key press events. |
GDK_KEY_RELEASE_MASK |
Receive key release events. |
GDK_ENTER_NOTIFY_MASK |
Receive window enter events. |
GDK_LEAVE_NOTIFY_MASK |
Receive window leave events. |
GDK_FOCUS_CHANGE_MASK |
Receive focus change events. |
GDK_STRUCTURE_MASK |
Receive events about window configuration change. |
GDK_PROPERTY_CHANGE_MASK |
Receive property change events. |
GDK_VISIBILITY_NOTIFY_MASK |
Receive visibility change events. |
GDK_PROXIMITY_IN_MASK |
Receive proximity in events. |
GDK_PROXIMITY_OUT_MASK |
Receive proximity out events. |
GDK_SUBSTRUCTURE_MASK |
Receive events about window configuration changes of child windows. |
GDK_SCROLL_MASK |
Receive scroll events. |
GDK_TOUCH_MASK |
Receive touch events. Since 3.4 |
GDK_SMOOTH_SCROLL_MASK |
Receive smooth scrolling events. Since 3.4 |
GDK_TOUCHPAD_GESTURE_MASK |
Receive touchpad gesture events. Since 3.18 |
GDK_TABLET_PAD_MASK |
Receive tablet pad events. Since 3.22 |
GDK_ALL_EVENTS_MASK |
The combination of all the above event masks. |