Gjsify LogoGjsify Logo

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.

bitfield

Index

Enumeration Members

ALL_EVENTS_MASK: number

the combination of all the above event masks.

BUTTON1_MOTION_MASK: number

receive pointer motion events while 1 button is pressed

BUTTON2_MOTION_MASK: number

receive pointer motion events while 2 button is pressed

BUTTON3_MOTION_MASK: number

receive pointer motion events while 3 button is pressed

BUTTON_MOTION_MASK: number

receive pointer motion events while any button is pressed

BUTTON_PRESS_MASK: number

receive button press events

BUTTON_RELEASE_MASK: number

receive button release events

ENTER_NOTIFY_MASK: number

receive window enter events

EXPOSURE_MASK: number

receive expose events

FOCUS_CHANGE_MASK: number

receive focus change events

KEY_PRESS_MASK: number

receive key press events

KEY_RELEASE_MASK: number

receive key release events

LEAVE_NOTIFY_MASK: number

receive window leave events

POINTER_MOTION_HINT_MASK: number

deprecated. see the explanation above

POINTER_MOTION_MASK: number

receive all pointer motion events

PROPERTY_CHANGE_MASK: number

receive property change events

PROXIMITY_IN_MASK: number

receive proximity in events

PROXIMITY_OUT_MASK: number

receive proximity out events

SCROLL_MASK: number

receive scroll events

SMOOTH_SCROLL_MASK: number

receive smooth scrolling events. Since 3.4

STRUCTURE_MASK: number

receive events about window configuration change

SUBSTRUCTURE_MASK: number

receive events about window configuration changes of child windows

TABLET_PAD_MASK: number

receive tablet pad events. Since 3.22

TOUCHPAD_GESTURE_MASK: number

receive touchpad gesture events. Since 3.18

TOUCH_MASK: number

receive touch events. Since 3.4

VISIBILITY_NOTIFY_MASK: number

receive visibility change events

Legend

  • Module
  • Object literal
  • Variable
  • Function
  • Function with type parameter
  • Index signature
  • Type alias
  • Type alias with type parameter
  • Enumeration
  • Enumeration member
  • Property
  • Method
  • Interface
  • Interface with type parameter
  • Constructor
  • Property
  • Method
  • Index signature
  • Class
  • Class with type parameter
  • Constructor
  • Property
  • Method
  • Accessor
  • Index signature
  • Inherited constructor
  • Inherited property
  • Inherited method
  • Inherited accessor
  • Protected property
  • Protected method
  • Protected accessor
  • Private property
  • Private method
  • Private accessor
  • Static property
  • Static method