movetoplev(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