Tk_MoveToplevelWindow(3)                                       Tk Library Procedures                                      Tk_MoveToplevelWindow(3)

__________________________________________________________________________________________________________________________________________________

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 win-
       dow.  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 speci-
       fied.  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

Tk                                                                                                                        Tk_MoveToplevelWindow(3)