DISPCOUNT()
 Return the number of pending DISPEND() requests
------------------------------------------------------------------------------
 Syntax

     DISPCOUNT() --> nDispCount

 Returns

     DISPCOUNT() returns the number of DISPEND() calls required to restore
     the original display context.

 Description

     You can use DISPCOUNT() to determine the current display context.
     Clipper uses display contexts to buffer and to supervise screen
     output operations.

     Each call to DISPBEGIN() defines a new display context.  Output to the
     display context is suppressed until a matching DISPEND() statement
     executes.

     Since you may nest DISPBEGIN() calls, use DISPCOUNT() to determine
     whether there are pending screen refresh requests.

 Examples

     .  This example saves the setting of DISPCOUNT(), then releases
        all pending display contexts before writing to the screen:

        PROCEDURE ForceDisplay(cExp)
           LOCAL nSavCount

        nSavCount := DISPCOUNT()

        //  Discard pending display contexts
        DO WHILE ( DISPCOUNT() > 0)
           DISPEND()

        ENDDO

        DISPOUT(cExp)

        //  "Rewind" the current display context
        DO WHILE (DISPCCOUNT() < nSavCount )
           DISPBEGIN()
        ENDDO

        RETURN

 Files   Library is CLIPPER.LIB.

See Also: DISPBEGIN() DISPEND()