TkMoveToplevelWindow(3) Tk Library Procedures TkMoveToplevelWindow(3)

NAME
       TkMoveToplevelWindow - Adjust the position of a top-level window

SYNOPSIS
       ##iinncclluuddee <>

       TTkkMMoovveeTToopplleevveellWWiinnddooww((tkwin, x, y))

AARRGGUUMMEENNTTSS
       TkWindow   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  TTkkGGeeoommeettrryyRReeqquueesstt mechanism.  The procedure TTkkMMoovveeTToopplleevveellWWiinn-
       ddooww may be used by an application to request a particular position  for
       a  top-level  window;   this procedure is similar in function to the wwmm
       ggeeoommeettrryy 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 TTkkMMoovveeTToopplleevveellWWiinnddooww 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
       TTkkDDooWWhheennIIddllee mechanism.


KKEEYYWWOORRDDSS
       position, top-level window, window manager



Tk                                                    TkMoveToplevelWindow(3)