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


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.


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.


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