NAME

XRestackWindows − change the stacking order of siblings. 

Synopsis

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

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

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

nwindowsSpecifies 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 siblings 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_redirect 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.  Otherwise, 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(). 

Copyright O’Reilly & Assoc.  —