windep(3G)

NAME
     windep - measures how deep a window is in the window stack

FORTRAN 77 SPECIFICATION
     integer*4 function windep(gwid)
     integer*4 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
     windep 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.

     windep 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.

     windep 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.  windep returns a number which can be
     compared against the windep return value for other windows to determine
     the stacking order of a program's windows on the screen.

     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, winpus

NOTE
     This routine is available only in immediate mode.