XQueryTree(3X11)              SDK X11 R4.11MU05             XQueryTree(3X11)


NAME
       XQueryTree - query window tree information

SYNTAX
       Status XQueryTree(display, w, rootreturn, parentreturn,
       childrenreturn, nchildrenreturn)
             Display *display;
             Window w;
             Window *rootreturn;
             Window *parentreturn;
             Window **childrenreturn;
             unsigned int *nchildrenreturn;

ARGUMENTS
       childrenreturn
                 Returns the list of children.

       display   Specifies the connection to the X server.

       nchildrenreturn
                 Returns the number of children.

       parentreturn
                 Returns the parent window.

       rootreturn
                 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, 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 returns zero if it fails and nonzero if it succeeds.  To
       free this 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


Licensed material--property of copyright holder(s)