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
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 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
Tcl_DoWhenIdle mechanism.

KEYWORDS

position, top-level window, window manager

Tk Tk_MoveToplevelWindow(3)