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

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies 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 Reference Manual