
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper 5.3 . Guide To CA-Clipper - <b>dispcount()</b>
[<<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()
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson