ultrix man page for xquerytree

XQueryTree(3X11)						     MIT X11R4							  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 a pointer to 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 function returns the root ID, the parent window ID, a pointer to the list of children windows, and the number of children in the list
       for the specified window.  The children are listed in current stacking order, from bottommost (first) to topmost (last).  returns zero if
       it fails and nonzero if it succeeds.  To free this list when it is no longer needed, use

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

See Also
       XFree(3X11), XGetWindowAttributes(3X11), XQueryPointer(3X11)
       X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys

																  XQueryTree(3X11)