1Tk_MoveToplevelWindow(3) Tk Library Procedures Tk_MoveToplevelWindow(3)
2______________________________________________________________________________
6
8 Tk_MoveToplevelWindow - Adjust the position of a top-level window
9
11 #include <tk.h>
12 Tk_MoveToplevelWindow(tkwin, x, y)
14
16 Tk_Window tkwin (in) Token for top-level window to move.
17 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 tk‐
21 win by the window manager, if there is
22 one.
23 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 tk‐
27 win by the window manager, if there is
28 one.
29______________________________________________________________________________
30
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 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 Tcl_DoWhenIdle mechanism.
49
51 position, top-level window, window manager
52Tk Tk_MoveToplevelWindow(3)