Tk_MoveToplevelWindow(3) Tk 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 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 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.
Page 1 (printed 2/26/99)
Tk_MoveToplevelWindow(3) Tk Tk_MoveToplevelWindow(3)
KEYWORDS
position, top-level window, window manager
Page 2 (printed 2/26/99)