windepth(3G) windepth(3G)
NAME
windepth - measures how deep a window is in the window stack
C SPECIFICATION
long windepth(gwid)
long gwid;
PARAMETERS
gwid expects the window identifier for the window you want to test.
FUNCTION RETURN VALUE
The returned value of this function is a number that you can use to
determine that stacking order of windows on the screen.
DESCRIPTION
windepth returns a number which can be compared against the windepth
return value for other windows to determine the stacking order of a
program's windows on the screen.
windepth does not indicate the depth of a window in relation to all other
windows on the screen. It is only useful in determining the relationship
of all windows controlled by the same process.
windepth can neither be used generally to see if a window is completely
exposed nor to determine the relationship of a window to other windows
belonging to other processes.
When using the Distributed Graphics Library (DGL), the graphics window
identifier also identifies the graphics server associated with the
window. The DGL directs all subsequent Graphics Library input and output
to the server associated with gwid.
SEE ALSO
winpop, winpush
NOTE
This routine is available only in immediate mode.
Page 1