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.
DescriptionXCirculateSubwindowsUp() raises the lowest mapped child of the speci‐
fied 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 win‐
dow, then a CirculateRequest event is sent to that client, and no fur‐
ther processing is performed. This allows the window manager to inter‐
cept this request when w is the root window. Normally, only the window
manager will call XCirculateSubwindowsUp() on the root window.
For more information, see Volume One, Chapter 16, Window Management.
Errors
BadWindow
See AlsoXCirculateSubwindows(), XCirculateSubwindowsDown(), XConfigureWindow(),
XLowerWindow(), XMoveResizeWindow(), XMoveWindow(), XQueryTree(),
XRaiseWindow(), XReparentWindow(), XResizeWindow(), XRestackWindows().
Xlib - Window Manipulation XCirculateSubwindowsUp()