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