Tk_MoveToplevelWindow(3tk)

Tk_MoveToplevelWindow(3Tk Library ProcedureTk_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  win-
     dow  manager  is  effectively the geometry manager;  Tk pro-
     vides 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  con-
     veyed  using  the  usual  Tk_GeometryRequest mechanism.  The
     procedure Tk_MoveToplevelWindow may be used by  an  applica-
     tion  to  request a particular position for a top-level win-
     dow;  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 Tk_DoWhenIdle mechanism.

Tk                        Last change:                          1

Tk_MoveToplevelWindow(3Tk Library ProcedureTk_MoveToplevelWindow(3)

KEYWORDS

     position, top-level window, window manager

Tk                        Last change:                          2