Tk_MoveToplevelWindow

About Us Documentation

Contact Site Map
 

  

WinPak
Documentation

Tk_MoveToplevelWindow






Prepared by Ready-to-Run Software, Inc. 

Tk_MoveToplevelWindow(Tk Library Procedures




_________________________________________________________________

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







Prepared by Ready-to-Run Software, Inc. 

Tk_MoveToplevelWindow(Tk Library Procedures




KEYWORDS

position, top-level window, window manager





















































Tk                                                              2



Prepared by Ready-to-Run Software, Inc. 

To return to the Ready-to-Run Software Super ReadyPak Table of contents please presshere

 

Email addresses listed on this site may  NOT be used for unsolicited commercial email.

Ready-to-Run Software, Inc Privacy Statement

Portions (c)Copyright, 1996-2005 by Ready-to-Run Software, Inc
(All rights reserved.)
212 Cedar Cove
Lansing, NY 14882
Phone: 607 533 UNIX (8649)
Fax: 607 533 4002