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
32

DESCRIPTION

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

KEYWORDS

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