xfree(3) [x11r4 man page]

XFree(3)							  XLIB FUNCTIONS							  XFree(3)

NAME

       XFree - free client data

SYNTAX

       int XFree(void *data);

ARGUMENTS

       data	 Specifies the data that are to be freed.

DESCRIPTION

       The XFree function is a general-purpose Xlib routine that frees the specified data.  You must use it to free any objects that were allo-
       cated by Xlib, unless an alternate function is explicitly specified for the object.  A NULL pointer cannot be passed to this function.

SEE ALSO

       Xlib - C Language X Interface

X Version 11							   libX11 1.2.1 							  XFree(3)

XQueryTree(3)							  XLIB FUNCTIONS						     XQueryTree(3)

NAME

       XQueryTree - query window tree information

SYNTAX

       Status XQueryTree(Display *display, Window w, Window *root_return, Window *parent_return, Window **children_return, unsigned int *nchil-
	      dren_return);

ARGUMENTS

       children_return
		 Returns the list of children.

       display	 Specifies the connection to the X server.

       nchildren_return
		 Returns the number of children.

       parent_return
		 Returns the parent window.

       root_return
		 Returns the root window.

       w	 Specifies the window whose list of children, root, parent, and number of children you want to obtain.

DESCRIPTION

       The XQueryTree function returns the root ID, the parent window ID, a pointer to the list of children windows (NULL when there are no chil-
       dren), and the number of children in the list for the specified window.	The children are listed in current stacking order, from bottom-
       most (first) to top-most (last).  XQueryTree returns zero if it fails and nonzero if it succeeds.  To free a non-NULL children list when it
       is no longer needed, use XFree.

       XQueryTree can generate a BadWindow error.

BUGS

       This really should return a screen *, not a root window ID.

DIAGNOSTICS

       BadWindow A value for a Window argument does not name a defined Window.

SEE ALSO

       XFree(3), XGetWindowAttributes(3), XQueryPointer(3)
       Xlib - C Language X Interface

X Version 11							   libX11 1.6.0 						     XQueryTree(3)