hpux man page for xquerytree

XQueryTree()															      XQueryTree()

Name
  XQueryTree - return a list of children, parent, and root.

Synopsis
  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
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  w	    Specifies  the  ID	of the window to be queried.  For this window, XQueryTree() will list its children, its root, its parent, and
	    the number of children.

  root_return
	    Returns the root ID for the specified window.

  parent_return
	    Returns the parent window of the specified window.

  children_return
	    Returns the list of children associated with the specified window.

  nchildren_return
	    Returns the number of children associated with the specified window.

Returns
  Zero on failure, non-zero on success.

Description
  XQueryTree() uses its last four arguments to return the root ID, the parent ID, a pointer to a list of children and the number of  children
  in that list, all for the specified window w.  The children_return are listed in current stacking order, from bottommost (first) to topmost
  (last).  XQueryTree() returns zero if it fails, non-zero if it succeeds.

  You should deallocate the list of children with XFree() when it is no longer needed.

Errors
  BadWindow

See Also
  XCirculateSubwindows(),  XCirculateSubwindowsDown(),	XCirculateSubwindowsUp(),  XConfigureWindow(),	XLowerWindow(),  XMoveResizeWindow(),
  XMoveWindow(), XRaiseWindow(), XReparentWindow(), XResizeWindow(), XRestackWindows().

Xlib - Window Manipulation													      XQueryTree()