hpux man page for xrestackwindows

XRestackWindows()														 XRestackWindows()

Name
  XRestackWindows - change the stacking order of siblings.

Synopsis
  XRestackWindows(display, windows, nwindows);
	Display *display;
	Window windows[];
	int nwindows;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  windows   Specifies an array containing the windows to be restacked.	All the windows must have a common parent.

  nwindows  Specifies the number of windows in the windows array.

Description
  XRestackWindows()  restacks  the windows in the order specified, from top to bottom.	The stacking order of the first window in the windows
  array will be on top, and the other windows will be stacked underneath it in the order of the array.	Note that you can exclude other  sib-
  lings from the windows array so that the top window in the array will not move relative to these other siblings.

  For each window in the window array that is not a child of the specified window, a BadMatch error will be generated.	If the override_redi-
  rect attribute of the window is False and the window manager has selected SubstructureRedirectMask on  the  parent,  then  ConfigureRequest
  events  are  sent to the window manager for each window whose override_redirect is not set, and no further processing is performed.  Other-
  wise, the windows will be restacked in top to bottom order.

Errors
  BadMatch
  BadWindow

See Also
  XCirculateSubwindows(),  XCirculateSubwindowsDown(),	XCirculateSubwindowsUp(),  XConfigureWindow(),	XLowerWindow(),  XMoveResizeWindow(),
  XMoveWindow(), XQueryTree(), XRaiseWindow(), XReparentWindow(), XResizeWindow().

Xlib - Window Manipulation													 XRestackWindows()