Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
Tk_MoveToplevelWindow(3)     Tk	Library	Procedures    Tk_MoveToplevelWindow(3)

______________________________________________________________________________

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 tk-
				     win  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 tk-
				     win 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
       Tcl_DoWhenIdle mechanism.

KEYWORDS
       position, top-level window, window manager

Tk						      Tk_MoveToplevelWindow(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_MoveToplevelWindow.tk86&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help