XLIB Programming Manual, Rel. 5, Third Edition

Appendix E. Event Reference

This appendix provides a detailed description of each event type in a reference page format. The information provided here is essential for a full understanding of the events, how they are selected and propagated, and the intricacies of their operation.

This appendix describes each event structure in detail and briefly shows how each event type is used. It covers the most common uses of each event type, the information contained in each event structure, how the event is selected, and the side effects of the event, if any. Each event is described on a separate reference page.

E.1 Meaning of Common Structure Elements

Example E-1 shows the XEvent union and a simple event structure that is one member of the union. Several of the members of this structure are present in nearly every event structure. They are described here before we go into the event-specific members (see also 8.2.2 Event Types and XEvent Union).

Example E-1. XEvent union and XAnyEvent structure

typedef union _XEvent { int type; /* Must not be changed; first member */ XAnyEvent xany; XButtonEvent xbutton; XCirculateEvent xcirculate; XCirculateRequestEvent xcirculaterequest; XClientMessageEvent xclient; XColormapEvent xcolormap; XConfigureEvent xconfigure; XConfigureRequestEvent xconfigurerequest; XCreateWindowEvent xcreatewindow; XDestroyWindowEvent xdestroywindow; XCrossingEvent xcrossing; XExposeEvent xexpose; XFocusChangeEvent xfocus; XNoExposeEvent xnoexpose; XGraphicsExposeEvent xgraphicsexpose; ...