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)