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.

  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 children),
  and the number of children in the list for the specified window.  The chil-
  dren are listed in current stacking order, from bottommost (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