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)