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

GDK_EXPOSURE_MASK

Receive expose events.

  • Value: 2
  • Available since: 3.0
GDK_POINTER_MOTION_MASK

Receive all pointer motion events.

  • Value: 4
  • Available since: 3.0
GDK_POINTER_MOTION_HINT_MASK

Deprecated. see the explanation above.

  • Value: 8
  • Available since: 3.0
GDK_BUTTON_MOTION_MASK

Receive pointer motion events while any button is pressed.

  • Value: 16
  • Available since: 3.0
GDK_BUTTON1_MOTION_MASK

Receive pointer motion events while 1 button is pressed.

  • Value: 32
  • Available since: 3.0
GDK_BUTTON2_MOTION_MASK

Receive pointer motion events while 2 button is pressed.

  • Value: 64
  • Available since: 3.0
GDK_BUTTON3_MOTION_MASK

Receive pointer motion events while 3 button is pressed.

  • Value: 128
  • Available since: 3.0
GDK_BUTTON_PRESS_MASK

Receive button press events.

  • Value: 256
  • Available since: 3.0
GDK_BUTTON_RELEASE_MASK

Receive button release events.

  • Value: 512
  • Available since: 3.0
GDK_KEY_PRESS_MASK

Receive key press events.

  • Value: 1024
  • Available since: 3.0
GDK_KEY_RELEASE_MASK

Receive key release events.

  • Value: 2048
  • Available since: 3.0
GDK_ENTER_NOTIFY_MASK

Receive window enter events.

  • Value: 4096
  • Available since: 3.0
GDK_LEAVE_NOTIFY_MASK

Receive window leave events.

  • Value: 8192
  • Available since: 3.0
GDK_FOCUS_CHANGE_MASK

Receive focus change events.

  • Value: 16384
  • Available since: 3.0
GDK_STRUCTURE_MASK

Receive events about window configuration change.

  • Value: 32768
  • Available since: 3.0
GDK_PROPERTY_CHANGE_MASK

Receive property change events.

  • Value: 65536
  • Available since: 3.0
GDK_VISIBILITY_NOTIFY_MASK

Receive visibility change events.

  • Value: 131072
  • Available since: 3.0
GDK_PROXIMITY_IN_MASK

Receive proximity in events.

  • Value: 262144
  • Available since: 3.0
GDK_PROXIMITY_OUT_MASK

Receive proximity out events.

  • Value: 524288
  • Available since: 3.0
GDK_SUBSTRUCTURE_MASK

Receive events about window configuration changes of child windows.

  • Value: 1048576
  • Available since: 3.0
GDK_SCROLL_MASK

Receive scroll events.

  • Value: 2097152
  • Available since: 3.0
GDK_TOUCH_MASK

Receive touch events. Since 3.4

  • Value: 4194304
  • Available since: 3.0
GDK_SMOOTH_SCROLL_MASK

Receive smooth scrolling events. Since 3.4

  • Value: 8388608
  • Available since: 3.0
GDK_TOUCHPAD_GESTURE_MASK

Receive touchpad gesture events. Since 3.18

  • Value: 16777216
  • Available since: 3.0
GDK_TABLET_PAD_MASK

Receive tablet pad events. Since 3.22

  • Value: 33554432
  • Available since: 3.0
GDK_ALL_EVENTS_MASK

The combination of all the above event masks.

  • Value: 67108862
  • Available since: 3.0