This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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 topleft
                                     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 topleft
                                     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



Tk                                                                                  Tk_MoveToplevelWindow(3)