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
31

DESCRIPTION

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

KEYWORDS

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