1Tk_MoveToplevelWindow(3)     Tk Library Procedures    Tk_MoveToplevelWindow(3)
2
3
4
5______________________________________________________________________________
6

NAME

8       Tk_MoveToplevelWindow - Adjust the position of a top-level window
9

SYNOPSIS

11       #include <tk.h>
12
13       Tk_MoveToplevelWindow(tkwin, x, y)
14

ARGUMENTS

16       Tk_Window tkwin (in)          Token for top-level window to move.
17
18       int x (in)                    New  x-coordinate  for the top-left pixel
19                                     of tkwin's border, or the top-left  pixel
20                                     of  the  decorative  border  supplied for
21                                     tkwin by the window manager, if there  is
22                                     one.
23
24       int y (in)                    New  y-coordinate  for the top-left pixel
25                                     of tkwin's border, or the top-left  pixel
26                                     of  the  decorative  border  supplied for
27                                     tkwin by the window manager, if there  is
28                                     one.
29______________________________________________________________________________
30

DESCRIPTION

32       In general, a window should never set its own position;  this should be
33       done only by the geometry manger that is responsible  for  the  window.
34       For  top-level  windows  the window manager is effectively the geometry
35       manager;  Tk provides interface code between the  application  and  the
36       window manager to convey the application's desires to the geometry man‐
37       ager.  The desired size for a top-level window is  conveyed  using  the
38       usual  Tk_GeometryRequest mechanism.  The procedure Tk_MoveToplevelWin‐
39       dow may be used by an application to request a particular position  for
40       a  top-level  window;   this procedure is similar in function to the wm
41       geometry Tcl command except that negative offsets cannot be  specified.
42       It is invoked by widgets such as menus that want to appear at a partic‐
43       ular place on the screen.
44
45       When Tk_MoveToplevelWindow is called it does not  immediately  pass  on
46       the  new desired location to the window manager;  it defers this action
47       until  all  other  outstanding  work  has  been  completed,  using  the
48       Tk_DoWhenIdle mechanism.
49

KEYWORDS

51       position, top-level window, window manager
52
53
54
55Tk                                                    Tk_MoveToplevelWindow(3)
Impressum