Manual Pages for UNIX Operating System command usage for man Tk_MoveToplevelWindow

Tk Library Procedures                  Tk_MoveToplevelWindow(3TK)



_________________________________________________________________

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

SYNOPSIS
     #include 

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




Tk                        Last change:                          1






Tk Library Procedures                  Tk_MoveToplevelWindow(3TK)



KEYWORDS
     position, top-level window, window manager

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tk-8   |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for Tk is available on http://opensolaris.org.






































Tk                        Last change:                          2