Tk_MoveToplevelWindow - level window
#include <tk.h> Tk_MoveToplevelWindow(tkwin, x, y)
Tk Library Procedures Tk_MoveToplevelWindow(3tk)
______________________________________________________________________________
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 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 Tk_GeometryRequest mechanism. The procedure Tk_MoveToplevelWin-
dow 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 partic-
ular 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.
KEYWORDS
position, top-level window, window manager
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | runtime/tk-8 |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://source-
forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.
Further information about this software can be found on the open source
community website at https://www.tcl.tk/.
Tk
Tk_MoveToplevelWindow(3tk)