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)