HPUX MoveToplev[3]

 Tk_MoveToplevelWindow(3)            Tk             Tk_MoveToplevelWindow(3)

 Tk Library Procedures                                 Tk Library Procedures





 ___________________________________________________________________________

 NAME
      Tk_MoveToplevelWindow - Adjust the position of a top-level window

 SYNOPSIS
      #include <tk.h>

      Tk_MoveToplevelWindow(tkwin, x, y)

 ARGUMENTS
      Tk_Window   tkwin   (in)      Token for top-level window to move.

      int         x       (in)      New x-coordinate for the top-left  pixel
                                    of tkwin's border, or the top-left pixel
                                    of the decorative  border  supplied  for
                                    tkwin by the window manager, if there is
                                    one.

      int         y       (in)      New y-coordinate for the top-left  pixel
                                    of tkwin's border, or the top-left pixel
                                    of the decorative  border  supplied  for
                                    tkwin by the window manager, if there is
                                    one.
 ___________________________________________________________________________


 DESCRIPTION
      In general, a window should never set its own position;   this  should
      be  done  only  by  the  geometry  manger  that is responsible for the
      window.  For top-level windows the window manager is  effectively  the
      geometry  manager;  Tk provides interface code between the application
      and the window manager to convey  the  application's  desires  to  the
      geometry manager.  The desired size for a top-level window is conveyed
      using  the  usual   Tk_GeometryRequest   mechanism.    The   procedure
      Tk_MoveToplevelWindow  may  be  used  by  an  application to request a
      particular position for a top-level window;  this procedure is similar
      in  function  to  the  wm  geometry  Tcl  command except that negative
      offsets cannot be specified.  It is invoked by widgets such  as  menus
      that want to appear at a particular place on the screen.

      When Tk_MoveToplevelWindow is called it doesn't  immediately  pass  on
      the new desired location to the window manager;  it defers this action
      until all  other  outstanding  work  has  been  completed,  using  the
      Tk_DoWhenIdle mechanism.


 KEYWORDS
      position, top-level window, window manager



                                    - 1 -        Formatted:  August 11, 1996