Tk_GetVRootGeometry(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  vir-
       tual  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

Tk                                    4.0               Tk_GetVRootGeometry(3)