About Us Documentation

Contact Site Map
 

  

WinPak
Documentation

MoveToplev






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.

 

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


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