---
name: "Tk_GetVRootGeometry"
section: "3tk"
platform: "linux"
package: "tk8.6-doc"
version: "8.6.16-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Tk_GetVRootGeometry/3tk"
---

# Tk\_GetVRootGeometry(3tk)

Get location and size of virtual root for window

```

```

## 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