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 a pointer to the list of children for the specified window.

displaySpecifies 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 window.

root_returnReturns the root window ID for the specified window. 

wSpecifies the window ID. 

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. .PN 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

XGetWindowAttributes(3X), XQueryPointer(3X)
Xlib − C Language X Interface

1 March 1988