Index Index for
Section 3X11
Index Alphabetical
listing for X
Bottom of page Bottom of
page		 

XClientMessageEvent(3X11)


X11R6


NAME

  XClientMessageEvent - ClientMessage event structure


DESCRIPTION

  The structure for ClientMessage events contains:

       typedef struct {
	       int type;	       /* ClientMessage */
	       unsigned long serial;   /* # of last request processed by
					  server */
	       Bool send_event;	       /* true if this came from a SendEvent
					  request */
	       Display *display;       /* Display the event was read from */
	       Window window;
	       Atom message_type;
	       int format;
	       union {
		       char b[20];
		       short s[10];
		       long l[5];
		       } data;
       } XClientMessageEvent;

  When you receive this event, the structure members are set as follows.

  The type member is set to the event type constant name that uniquely
  identifies it. For example, when the X server reports a GraphicsExpose
  event to a client application, it sends an XGraphicsExposeEvent structure
  with the type member set to GraphicsExpose. The display member is set to a
  pointer to the display the event was read on. The send_event member is set
  to True if the event came from a SendEvent protocol request. The serial
  member is set from the serial number reported in the protocol but expanded
  from the 16-bit least-significant bits to a full 32-bit value. The window
  member is set to the window that is most useful to toolkit dispatchers.

  The message_type member is set to an atom that indicates how the data
  should be interpreted by the receiving client. The format member is set to
  8, 16, or 32 and specifies whether the data should be viewed as a list of
  bytes, shorts, or longs. The data member is a union that contains the
  members b, s, and l. The b, s, and l members represent data of twenty 8-bit
  values, ten 16-bit values, and five 32-bit values. Particular message types
  might not make use of all these values. The X server places no
  interpretation on the values in the window, message_type, or data members.


SEE ALSO

  XAnyEvent(3X11), XButtonEvent(3X11), XCreateWindowEvent(3X11),
  XCirculateEvent(3X11), XCirculateRequestEvent(3X11), XColormapEvent(3X11),
  XConfigureEvent(3X11), XConfigureRequestEvent(3X11), XCrossingEvent(3X11),
  XDestroyWindowEvent(3X11), XErrorEvent(3X11), XExposeEvent(3X11),
  XFocusChangeEvent(3X11), XGraphicsExposeEvent(3X11), XGravityEvent(3X11),
  XKeymapEvent(3X11), XMapEvent(3X11), XMapRequestEvent(3X11),
  XPropertyEvent(3X11), XReparentEvent(3X11), XResizeRequestEvent(3X11),
  XSelectionClearEvent(3X11), XSelectionEvent(3X11),
  XSelectionRequestEvent(3X11), XUnmapEvent(3X11), XVisibilityEvent(3X11)

  Xlib -- C Language X Interface

Index Index for
Section 3X11
Index Alphabetical
listing for X
Top of page Top of
page