hpux man page for xcirculateb

XCirculateSubwindowsDown()												XCirculateSubwindowsDown()

Name
  XCirculateSubwindowsDown - circulate the bottom child to the top of the stacking order.

Synopsis
  XCirculateSubwindowsDown(display, w)
	Display *display;
	Window w;

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

  w	    Specifies the window ID of the parent of the windows to be circulated.

Description
  XCirculateSubwindowsDown()  lowers  the  highest  mapped child of the specified window that partially or completely obscures another child.
  The lowered child goes to the bottom of the stack.  Completely unobscured children are not affected.

  This function generates exposure events on any window formerly obscured.  Repeated executions lead to round-robin lowering.  XCirculateSub-
  windowsDown() is equivalent to XCirculateSubwindows(display, w, LowerHighest).

  If some other client has selected SubstructureRedirectMask on the window, then a CirculateRequest event is sent to that client, and no fur-
  ther processing is performed.  This allows the window manager to intercept this request when w is the root window.  Normally, only the win-
  dow manager should call XCirculateSubwindowsDown() on the root window.

  For more information, see Volume One, Chapter 16, Window Management.

Errors
  BadWindow

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

Xlib - Window Manipulation												XCirculateSubwindowsDown()