xquerytree(3) [hpux man page]

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()

Check Out this Related Man Page

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)

Linux and UNIX Man Pages

xquerytree(3) [hpux man page]

Check Out this Related Man Page