Tcl 9.0/Tk9.0 Documentation > Tk C API, version 9.0.0 > Restack

Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

NAME

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

SYNOPSIS

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

ARGUMENTS

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.

DESCRIPTION

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>.

KEYWORDS

above, below, obscure, stacking order