Provided by: tk8.6-doc_8.6.8-4_all bug

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 does not  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