DragonFly On-Line Manual Pages

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)