'\"'\" Copyright (c) 1990-1993 The Regents of the University of California.'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.'\"'\" See the file "license.terms" for information on usage and redistribution'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.'\" '\" SCCS: @(#) MoveToplev.3 1.8 96/03/26 18:16:11'\" .so man.macros.TH Tk_MoveToplevelWindow 3 "" Tk "Tk Library Procedures".BS.SH NAMETk_MoveToplevelWindow \- Adjust the position of a top-level window.SH SYNOPSIS.nf\fB#include <tk.h>\fR.sp\fBTk_MoveToplevelWindow(\fItkwin, x, y\fB)\fR.SH ARGUMENTS.AS Tk_Window tkwin.AP Tk_Window tkwin inToken for top-level window to move..AP int x inNew x-coordinate for the top-left pixel of \fItkwin\fR's border, or thetop-left pixel of the decorative border supplied for \fItkwin\fR by thewindow manager, if there is one..AP int y inNew y-coordinate for the top-left pixel of \fItkwin\fR's border, or thetop-left pixel of the decorative border supplied for \fItkwin\fR by thewindow manager, if there is one..BE.SH DESCRIPTION.PPIn general, a window should never set its own position;  this should bedone only by the geometry manger that is responsible for the window.For top-level windows the window manager is effectively the geometrymanager;  Tk provides interface code between the application and thewindow manager to convey the application's desires to the geometrymanager.  The desired size for a top-level window is conveyed usingthe usual \fBTk_GeometryRequest\fR mechanism.  The procedure\fBTk_MoveToplevelWindow\fR may be used by an application to requesta particular position for a top-level window;  this procedure issimilar in function to the \fBwm geometry\fR Tcl command except thatnegative offsets cannot be specified.  It is invoked by widgets such asmenus that want to appear at a particular place on the screen..PPWhen \fBTk_MoveToplevelWindow\fR is called it doesn't immediatelypass on the new desired location to the window manager;  it defersthis action until all other outstanding work has been completed,using the \fBTk_DoWhenIdle\fR mechanism..SH KEYWORDSposition, top-level window, window manager