[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 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.
     CA-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()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson