Name
XtBuildEventMask — retrieve a widget’s event mask.
Synopsis
EventMask XtBuildEventMask(w)
Widget w;
Arguments
wSpecifies the widget.
Description
XtBuildEventMask returns a widget’s event mask. The mask reflects the events the widget is currently selecting. (If the widget is unrealized, then the mask reflects the events the widget will select when it is realized.) This event mask is the logical OR of all event masks selected by adding event handlers and event translations (including accelerators).
This event mask is stored in the XSetWindowAttributes structure by XtRealizeWidget and is sent to the server when event handlers and translations are installed or removed for the realized widget.
Structures
The event_mask is formed by combining the event mask symbols listed in the first column of the table below using the bitwise OR operator (|). Each mask symbol sets a bit in the event_mask.
The table also briefly describes the circumstances under which you would want to specify each symbol.
| Event Mask Symbol | Circumstances | |
| NoEventMask | No events | |
| KeyPressMask | Keyboard down events | |
| KeyReleaseMask | Keyboard up events | |
| ButtonPressMask | Pointer button down events | |
| ButtonReleaseMask | Pointer button up events | |
| EnterWindowMask | Pointer window entry events | |
| LeaveWindowMask | Pointer window leave events | |
| PointerMotionMask | All pointer motion events | |
| PointerMotionHintMask | Fewer pointer motion events | |
| Button1MotionMask | Pointer motion while button 1 down | |
| Button2MotionMask | Pointer motion while button 2 down | |
| Button3MotionMask | Pointer motion while button 3 down | |
| Button4MotionMask | Pointer motion while button 4 down | |
| Button5MotionMask | Pointer motion while button 5 down | |
| ButtonMotionMask | Pointer motion while any button down | |
| KeymapStateMask | Any keyboard state change on EnterNotify, | |
| LeaveNotify, FocusIn or FocusOut | ||
| ExposureMask | Any exposure (except GraphicsExpose and | |
| NoExpose) | ||
| VisibilityChangeMask | Any change in visibility | |
| StructureNotifyMask | Any change in window configuration. | |
| ResizeRedirectMask | Redirect resize of this window | |
| SubstructureNotifyMask | Notify about reconfiguration of children | |
| SubstructureRedirectMask | Redirect reconfiguration of children | |
| FocusChangeMask | Any change in keyboard focus | |
| PropertyChangeMask | Any change in property | |
| ColormapChangeMask | Any change in colormap | |
| OwnerGrabButtonMask | Modifies handling of pointer events |
See Also
XtAddEventHandler(1), XtAddRawEventHandler(1), XtRealizeWidget(1).