TkGetVRootGeometry(3) Tk Library Procedures TkGetVRootGeometry(3)

NAME
       TkGetVRootGeometry - Get location and size of virtual root for window

SYNOPSIS
       ##iinncclluuddee <>

       TTkkGGeettVVRRoooottGGeeoommeettrryy((tkwin, xPtr, yPtr, widthPtr, heightPtr))

AARRGGUUMMEENNTTSS
       TkWindow   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
       TTkkGGeettVVRRoooottGGeeoommeettrryy 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 SSWWMMRROOOOTT or WWMMRROOOOTT  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.


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



Tk                                    4.0               TkGetVRootGeometry(3)