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

NAME

8       Tk_GetVRootGeometry - Get location and size of virtual root for window
9

SYNOPSIS

11       #include <tk.h>
12
13       Tk_GetVRootGeometry(tkwin, xPtr, yPtr, widthPtr, heightPtr)
14

ARGUMENTS

16       Tk_Window tkwin (in)              Token  for  window whose virtual root
17                                         is to be queried.
18
19       int xPtr (out)                    Points to word in which to  store  x-
20                                         offset of virtual root.
21
22       int yPtr (out)                    Points  to  word in which to store y-
23                                         offset of virtual root.
24
25       int widthPtr (out)                Points to  word  in  which  to  store
26                                         width of virtual root.
27
28       int heightPtr (out)               Points  to  word  in  which  to store
29                                         height of virtual root.
30______________________________________________________________________________
31

DESCRIPTION

33       Tk_GetVRootGeometry returns geometry information about the virtual root
34       window associated with tkwin.  The “associated” virtual root is the one
35       in which tkwin's nearest top-level ancestor (or tkwin itself if it is a
36       top-level window) has been reparented by the window manager.  This win‐
37       dow is identified by a __SWM_ROOT or __WM_ROOT property placed  on  the
38       top-level  window  by  the  window manager.  If tkwin is not associated
39       with a virtual root (e.g.  because the window manager does not use vir‐
40       tual  roots)  then  *xPtr  and *yPtr will be set to 0 and *widthPtr and
41       *heightPtr will be set to  the  dimensions  of  the  screen  containing
42       tkwin.
43

KEYWORDS

45       geometry, height, location, virtual root, width, window manager
46
47
48
49Tk                                    4.0               Tk_GetVRootGeometry(3)