XCirculateSubwindows()XCirculateSubwindows()Name
XCirculateSubwindows – circulate the stacking order of children up or
down.
Synopsis
XCirculateSubwindows(display, w, direction)
Display *display;
Window w;
int direction;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the window ID of the parent of the subwindows to be
circulated.
direction Specifies the direction (up or down) that you want to circu‐
late the children. Pass either RaiseLowest or LowerHighest.
DescriptionXCirculateSubwindows() circulates the children of the specified window
in the specified direction, either RaiseLowest or LowerHighest. If
some other client has selected SubstructureRedirectMask on the speci‐
fied window, then a CirculateRequest event is generated, and no further
processing is performed. If you specify RaiseLowest, this function
raises the lowest mapped child (if any) that is occluded by another
child to the top of the stack. If you specify LowerHighest, this func‐
tion lowers the highest mapped child (if any) that occludes another
child to the bottom of the stack. Exposure processing is performed on
formerly obscured windows. If a child is actually restacked, the X
server generates a CirculateNotify event.
For more information, see Volume One, Chapter 16, Window Management.
Errors
BadValue
BadWindow
See AlsoXCirculateSubwindowsDown(), XCirculateSubwindowsUp(), XConfigureWin‐
dow(), XLowerWindow(), XMoveResizeWindow(), XMoveWindow(), XQuery‐
Tree(), XRaiseWindow(), XReparentWindow(), XResizeWindow(), XRestack‐
Windows().
Xlib - Window Manipulation XCirculateSubwindows()