Tk_MoveToplevelWindow(Tk Library ProcedurTk_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 top-
level 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
Tk 1
Tk_MoveToplevelWindow(Tk Library ProcedurTk_MoveToplevelWindow(3)
mechanism.
KEYWORDS
position, top-level window, window manager
Tk 2
