xquerytree(3x11) [redhat man page]
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. you want to obtain w Specifies the window whose list of children, root, parent, and number of children. 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 chil- dren), and the number of children in the list for the specified window. The children are listed in current stacking order, from bottom- most (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 X Version 11 Release 6.6 XQueryTree(3X11)
Check Out this Related Man Page
XQueryTree(3) XLIB FUNCTIONS XQueryTree(3) NAME
XQueryTree - query window tree information SYNTAX
Status XQueryTree(Display *display, Window w, Window *root_return, Window *parent_return, Window **children_return, unsigned int *nchil- dren_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 chil- dren), and the number of children in the list for the specified window. The children are listed in current stacking order, from bottom- most (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. XQueryTree can generate a BadWindow error. BUGS
This really should return a screen *, not a root window ID. DIAGNOSTICS
BadWindow A value for a Window argument does not name a defined Window. SEE ALSO
XFree(3), XGetWindowAttributes(3), XQueryPointer(3) Xlib - C Language X Interface X Version 11 libX11 1.5.0 XQueryTree(3)