MoveToplev.3
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
- '"
- '" 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.
- '"
- '" RCS: @(#) $Id: MoveToplev.3,v 1.2 1998/09/14 18:22:52 stanton Exp $
- '"
- .so man.macros
- .TH Tk_MoveToplevelWindow 3 "" Tk "Tk Library Procedures"
- .BS
- .SH NAME
- Tk_MoveToplevelWindow - Adjust the position of a top-level window
- .SH SYNOPSIS
- .nf
- fB#include <tk.h>fR
- .sp
- fBTk_MoveToplevelWindow(fItkwin, x, yfB)fR
- .SH ARGUMENTS
- .AS Tk_Window tkwin
- .AP Tk_Window tkwin in
- Token for top-level window to move.
- .AP int x in
- New x-coordinate for the top-left pixel of fItkwinfR's border, or the
- top-left pixel of the decorative border supplied for fItkwinfR by the
- window manager, if there is one.
- .AP int y in
- New y-coordinate for the top-left pixel of fItkwinfR's border, or the
- top-left pixel of the decorative border supplied for fItkwinfR by the
- window manager, if there is one.
- .BE
- .SH DESCRIPTION
- .PP
- 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
- manager. The desired size for a top-level window is conveyed using
- the usual fBTk_GeometryRequestfR mechanism. The procedure
- fBTk_MoveToplevelWindowfR may be used by an application to request
- a particular position for a top-level window; this procedure is
- similar in function to the fBwm geometryfR 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.
- .PP
- When fBTk_MoveToplevelWindowfR 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 fBTk_DoWhenIdlefR mechanism.
- .SH KEYWORDS
- position, top-level window, window manager