Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XClientMessageEvent(3)		XLIB FUNCTIONS		XClientMessageEvent(3)

       XClientMessageEvent - ClientMessage event structure

       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	struc-
       ture 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  re-
       quest.  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 use-
       ful 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, mes-
       sage_type, or data members.

       XAnyEvent(3),   XButtonEvent(3),	   XCreateWindowEvent(3),    XCircula-
       teEvent(3),   XCirculateRequestEvent(3),	  XColormapEvent(3),  XConfig-
       ureEvent(3), XConfigureRequestEvent(3), XCrossingEvent(3), XDestroyWin-
       dowEvent(3),   XErrorEvent(3),  XExposeEvent(3),	 XFocusChangeEvent(3),
       XGraphicsExposeEvent(3),	      XGravityEvent(3),	      XKeymapEvent(3),
       XMapEvent(3),	 XMapRequestEvent(3),	 XPropertyEvent(3),    XRepar-
       entEvent(3), XResizeRequestEvent(3),  XSelectionClearEvent(3),  XSelec-
       tionEvent(3),   XSelectionRequestEvent(3),  XUnmapEvent(3),  XVisibili-
       Xlib - C	Language X Interface

X Version 11			 libX11	1.6.12		XClientMessageEvent(3)


Want to link to this manual page? Use this URL:

home | help