redhat man page for xquerytree

XQueryTree(3X11)						  XLIB FUNCTIONS						  XQueryTree(3X11)

NAME
       XQueryTree - query window tree information

SYNTAX
       Status XQueryTree(display, w, root_return, parent_return, children_return, nchildren_return)
	     Display *display;
	     Window w;
	     Window *root_return;
	     Window *parent_return;
	     Window **children_return;
	     unsigned int *nchildren_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.  you want to obtain

       w	 Specifies the window whose list of children, root, parent, and number of children.

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.

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

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

X Version 11							    Release 6.6 						  XQueryTree(3X11)