windepth(3G)							  windepth(3G)

NAME    [Toc]    [Back]

     windepth -	measures how deep a window is in the window stack

C SPECIFICATION    [Toc]    [Back]

     long windepth(gwid)
     long gwid;

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     winpop, winpush

NOTE    [Toc]    [Back]

     This routine is available only in immediate mode.


									PPPPaaaaggggeeee 1111