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.