This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

Tk_GetVRootGeometry(3)                      Tk Library Procedures                     Tk_GetVRootGeometry(3)



____________________________________________________________________________________________________________

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 iden-tified identified
       tified 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  dimen-sions dimensions
       sions of the screen containing tkwin.


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



Tk                                                   4.0                              Tk_GetVRootGeometry(3)