XQueryTree(3X)                                     XQueryTree(3X)



NAME
     XQueryTree - queries for window tree information

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;

DESCRIPTION
     The XQueryTree function returns the root window 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).  XQueryTree re-
     turns zero if it fails and nonzero if it success. To free
     this list when it is no longer needed, use XFree.

   Arguments
     This function accepts the following arguments:

     children-return
             Returns a pointer to the list of children for the
             specified window.

     display Specifies the connection to the X server.

     nchildren-return
             Returns the number of children for the specified
             window.

     parent-return
             Returns the parent window ID for the specified win-
             dow.

     root-return
             Returns the root window ID for the specified window.

     w       Specifies the window ID.

ERRORS
     BadWindow
             A value for a Window argument does not name a de-
             fined window.

LIMITATIONS
     This function should return a screen *, not a root window
     ID.



November, 1990                                                  1

XQueryTree(3X)                                     XQueryTree(3X)



SEE ALSO
     XFree(3X), XGetWindowAttributes(3X), XQueryPointer(3X)

     Xlib - C Language Interface




















































2                                                  November, 1990