Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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
     Tk_GetVRootGeometry 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 does not  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

Tk				       4.0		  Tk_GetVRootGeometry(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_GetVRootGeometry.tk86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help