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 bor
der 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 bor
der 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 window. 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 toplevel window; this procedure is similar in function to
the wm geometry Tcl command except that negative offsets
cannot be specified. 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 immedi
ately pass on the new desired location to the window man
ager; it defers this action until all other outstanding
work has been completed, using the Tk_DoWhenIdle mecha
nism.
KEYWORDS
- position, top-level window, window manager