Tk_GetVRootGeometry(3)Tk

_________________________________________________________________

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 vir-
                                         tual root.

       int         heightPtr   (out)     Points to word in  which
                                         to  store height of vir-
                                         tual root.
_________________________________________________________________

DESCRIPTION
       TkGetVRootGeometry returns geometry information about  the
       virtual  root window associated with tkwin.  The ``associ-
       ated'' 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