Tk_MoveToplevelWindow(3TK)				       Tk Library Procedures					Tk_MoveToplevelWindow(3TK)

__________________________________________________________________________________________________________________________________________________

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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk															Tk_MoveToplevelWindow(3TK)