getvroot(3Tk)

NAME
     Tk_GetVRootGeometry - Get location and size of virtual root for window

SYNOPSIS
     #include <tk.h>

     Tk_GetVRootGeometry(tkwin, xPtr, yPtr, widthPtr, heightPtr)

ARGUMENTS
     Tk_Window   tkwin       (in)      Token for window whose virtual root is
                                       to be queried.

     int         xPtr        (out)     Points to word in which to store x-
                                       offset of virtual root.

     int         yPtr        (out)     Points to word in which to store y-
                                       offset of virtual root.

     int         widthPtr    (out)     Points to word in which to store width |
                                       of virtual root.

     int         heightPtr   (out)     Points to word in which to store height|
                                       of virtual root.


DESCRIPTION
     TkGetVRootGeometry returns geometry information about the virtual root
     window associated with tkwin.  The ``associated'' virtual root is the one
     in which tkwin's nearest top-level ancestor (or tkwin itself if it is a
     top-level window) has been reparented by the window manager.  This window
     is identified by a __SWM_ROOT or __WM_ROOT property placed on the top-
     level window by the window manager.  If tkwin is not associated with a
     virtual root (e.g.  because the window manager doesn't use virtual roots)
     then *xPtr and *yPtr will be set to 0 and *widthPtr and *heightPtr will
     be set to the dimensions of the screen containing tkwin.


KEYWORDS
     geometry, height, location, virtual root, width, window manager