GetVRoot(3)

GetVRoot3

Get location and size of virtual root for window

Usage

#include <tk.h>

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

Arguments

Token for window whose virtual root is to be queried. Points to word in which to store x-offset of virtual root. Points to word in which to store y-offset of virtual root. Points to word in which to store width of virtual root. Points to word in which to store height of virtual root.

Overview

Tk_GetVRootGeometry returns geometry information about the virtual root window associated with tkwin. The 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

Releases

109 releases since Mac OS X 10.4; the text changed 1 time.

  1. 10.4–10.4.2
  2. 10.6–26.5

From tcl 152 in macOS 26.5. Parsed by carta from the page's man source.