Click above to get retro games delivered to your door ever month!

 FT_DISPCNT()
 Return the number of outstanding calls to DispBegin()
------------------------------------------------------------------------------

 Syntax

     FT_DispCnt() --> nCount

 Arguments

    None

 Returns

    An integer.

 Description

    Some routines (like exception handlers, for example) must be able to
    guarantee that their output makes it to the screen.  This can be
    difficult if a call to DispBegin() is in effect, because any error
    messages will be sent to Clipper's virtual screen buffer instead of
    the actual physical screen.  This function alleviates the problem by
    allowing you to determine if screen output is being buffered, and if
    so, how many DispEnd() calls are necessary to flush the buffer.

    Although this function does not use "internals" in the conventional
    sense, it still makes use of version-specific information in order
    to locate the virtual screen buffer.  DO NOT attempt to use this
    function with any version of Clipper other than 5.01.

 Examples


    function ErrorHandler()

    // Guarantee that the error message will reach the screen

    while FT_DispCnt() > 0 ; dispend(); end

    // Now it's okay to do the error message

    ErrorMessage( "Something terrible has happened" )

    return NIL


 Source: DISPCNT.ASM

 Author: Ted Means