HPUX GetVRoot[3]

 Tk_GetVRootGeometry(3)              Tk               Tk_GetVRootGeometry(3)

 Tk Library Procedures                                 Tk Library Procedures





 ___________________________________________________________________________

 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.

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

      unsigned 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







                                    - 1 -        Formatted:  August 11, 1996