Slaven Rezić > Tk-804.028 > Tk_GetVRootGeometry

Download:
Tk-804.028.tar.gz

Annotate this POD

CPAN RT

New  33
Open  54
Stalled  14
View/Report Bugs
Source   Latest Release: Tk-804.032_500

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 ^

TkGetVRootGeometry 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 doesn't 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

syntax highlighting: