Tcl 8.7/Tk8.7a5 Documentation > Tk C API > Restack

Tcl/Tk Applications | Tcl Commands | Tk Commands | Tcl C API | Tk C API


Tk_RestackWindow — Change a window's position in the stacking order


#include <tk.h>
Tk_RestackWindow(tkwin, aboveBelow, other)


Tk_Window tkwin (in)
Token for window to restack.

int aboveBelow (in)
Indicates new position of tkwin relative to other; must be Above or Below.

Tk_Window other (in)
Tkwin will be repositioned just above or below this window. Must be a sibling of tkwin or a descendant of a sibling. If NULL then tkwin is restacked above or below all siblings.


Tk_RestackWindow changes the stacking order of window relative to its siblings. If other is specified as NULL then window is repositioned at the top or bottom of its stacking order, depending on whether aboveBelow is Above or Below. If other has a non-NULL value then window is repositioned just above or below other.

The aboveBelow argument must have one of the symbolic values Above or Below. Both of these values are defined by the include file <X11/Xlib.h>.


above, below, obscure, stacking order
Copyright © 1990 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.