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  reposi­
                                          tioned  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 sib­
                                          lings.
_________________________________________________________________



DESCRIPTION

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

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



KEYWORDS

       above, below, obscure, stacking order