Copyright (c) 1990 The Regents of the University of California.
Copyright (c) 1994-1996 Sun Microsystems, Inc.

See the file "license.terms" for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES.

SCCS: @(#) GetVRoot.3 1.10 96/08/27 13:21:28

.so man.macros S Tk_GetVRootGeometry - Get location and size of virtual root for window

#include <tk.h>
Tk_GetVRootGeometry(tkwin, xPtr, yPtr, widthPtr, heightPtr)
 ARGUMENTS
.AS Tk_Window heightPtr
.AP Tk_Window tkwin in
Token for window whose virtual root is to be queried.
.AP int xPtr out
Points to word in which to store x-offset of virtual root.
.AP int yPtr out
Points to word in which to store y-offset of virtual root.
.AP "int" widthPtr out
Points to word in which to store width of virtual root.
.AP "int" heightPtr out
Points to word in which to store height of virtual root.
E 
 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