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 man-
       ager.  The desired size for a top-level window is  conveyed  using  the
       usual  Tk_GeometryRequest mechanism.  The procedure Tk_MoveToplevelWin-
       dow 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 partic-
       ular 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

Tk                                                    Tk_MoveToplevelWindow(3)