Tk\_GetVRootGeometry(3) Tk Library Procedures Tk\_GetVRootGeometry(3)

```

```

# [NAME](#NAME)

Tk\_GetVRootGeometry - Get location and size of virtual root for window

# [SYNOPSIS](#SYNOPSIS)

```
#include <tk.h>

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

# [ARGUMENTS](#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](#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](#KEYWORDS)

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

4.0 Tk

---

Document: Tk_GetVRootGeometry(3) from tk 9.1.0-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.1.0-src.tar.gz
