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 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 manager.  The desired
     size for a top-level window is conveyed 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 window;  this  proce-
     dure is similar in function to the wm geometry Tcl command except that neg-
     ative  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 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+15.1.quarterly>

home | help