opensolaris man page for tk_getvrootgeometry

Tk_GetVRootGeometry(3TK)				       Tk Library Procedures					  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  man-
       ager.   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

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES
       Source for Tk is available on http://opensolaris.org.

Tk									4.0						  Tk_GetVRootGeometry(3TK)