MirOS Manual: XQueryTree(3)


XQueryTree(3X11)         XLIB FUNCTIONS          XQueryTree(3X11)

NAME

     XQueryTree - query window tree information

SYNTAX

     Status XQueryTree(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 win-
     dow ID, a pointer to the list of children windows (NULL when
     there are no children), 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

XFree86                   Version 4.5.0                         1

Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.