XRestackWindows
Syntax
XRestackWindows(display, windows, nwindows);
Display *display;
Window windows[];
int nwindows;
Arguments
| display
| Specifies the connection to the X server.
|
| windows
| Specifies an array containing the windows to be restacked.
|
| nwindows
| Specifies the number of windows to be restacked.
|
Description
The
XRestackWindows()
function restacks the windows in the order specified,
from top to bottom.
The stacking order of the first window in the windows array is unaffected,
but the other windows in the array are stacked underneath the first window,
in the order of the array.
The stacking order of the other windows is not affected.
For each window in the window array that is not a child of the specified window,
a
BadMatch
error results.
If the override-redirect attribute of a window is
False
and some
other client has selected
SubstructureRedirectMask
on the parent, the X server generates
ConfigureRequest
events for each window whose override-redirect flag is not set,
and no further processing is performed.
Otherwise, the windows will be restacked in top to bottom order.
XRestackWindows()
can generate a
BadWindow
error.
Diagnostics
| BadWindow
| A value for a Window argument does not name a defined Window.
|
See also
XChangeWindowAttributes(),
XCirculateSubwindows(),
XCirculateSubwindowsDown(),
XCirculateSubwindowsUp(),
XConfigureWindow(),
XCreateWindow(),
XDestroyWindow(),
XLowerWindow(),
XMapWindow(),
XRaiseWindow(),
"Changing Window Stacking Order"
Christophe Tronche, ch@tronche.com