hpux man page for xcirculatec

XCirculateSubwindowsUp()												  XCirculateSubwindowsUp()

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

Synopsis
  XCirculateSubwindowsUp(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
  XCirculateSubwindowsUp()  raises the lowest mapped child of the specified window that is partially or completely obscured by another child.
  The raised child goes to the top of the stack.  This generates exposure events on the raised child (and its descendents, if any).  Repeated
  executions lead to round robin-raising.  Completely unobscured children are not affected.

  XCirculateSubwindowsUp() is equivalent to XCirculateSubwindows(display, w, RaiseLowest).

  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 will call XCirculateSubwindowsUp() on the root window.

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

Errors
  BadWindow

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

Xlib - Window Manipulation												  XCirculateSubwindowsUp()