# 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.
#
#
=head1 NAME
Tk_GetVRootGeometry - Get location and size of virtual root for window
=for category C Programming
=head1 SYNOPSIS
B<#include E<lt>tk.hE<gt>>
B<Tk_GetVRootGeometry(>I<tkwin, xPtr, yPtr, widthPtr, heightPtr>B<)>
=head1 ARGUMENTS
=over 4
=item Tk_Window tkwin (in)
Token for window whose virtual root is to be queried.
=item int xPtr (out)
Points to word in which to store x-offset of virtual root.
=item int yPtr (out)
Points to word in which to store y-offset of virtual root.
=item "int" widthPtr (out)
Points to word in which to store width of virtual root.
=item "int" heightPtr (out)
Points to word in which to store height of virtual root.
=back
=head1 DESCRIPTION
B<TkGetVRootGeometry> returns geometry information about the virtual
root window associated with I<tkwin>. The ``associated'' virtual
root is the one in which I<tkwin>'s nearest top-level ancestor (or
I<tkwin> itself if it is a top-level window) has
been reparented by the window manager. This window is identified by
a B<__SWM_ROOT> or B<__WM_ROOT> property placed on the top-level
window by the window manager.
If I<tkwin> is not associated with a virtual root (e.g.
because the window manager doesn't use virtual roots) then *I<xPtr> and
*I<yPtr> will be set to 0 and *I<widthPtr> and *I<heightPtr>
will be set to the dimensions of the screen containing I<tkwin>.
=head1 KEYWORDS
geometry, height, location, virtual root, width, window manager