Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XQueryTree()							  XQueryTree()

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
  display   Specifies	a  connection  to  an  X  server;  returned  from
	    XOpenDisplay().

  w	    Specifies the ID of the window to be queried.  For this  win‐
	    dow,  XQueryTree() will list its children, its root, its par‐
	    ent, 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  suc‐
  ceeds.

  You  should  deallocate the list of children with XFree() when it is no
  longer needed.

Errors
  BadWindow

See Also
  XCirculateSubwindows(),  XCirculateSubwindowsDown(),	XCirculateSubwin‐
  dowsUp(),   XConfigureWindow(),   XLowerWindow(),  XMoveResizeWindow(),
  XMoveWindow(),  XRaiseWindow(),   XReparentWindow(),	 XResizeWindow(),
  XRestackWindows().

Xlib - Window Manipulation					  XQueryTree()

Vote for polarhome