Enumeration

GdkEventMask

Declaration

flags Gdk.EventMask

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.