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.