Manual pages › X Window and screen libraries (3X)

XQTree(3X)

query window tree information

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

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 XWIN 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 win-
dow 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 bot-
tommost (first) to topmost (last).  XQueryTree returns zero
if it fails and nonzero if it succeeds.  To free this list
when it is no longer needed, use XFree.

BUGS