xHarbour Reference Documentation > Function Reference

DispCount()

Retrieves the number of pending DispEnd() calls.

Syntax

DispCount() --> nDispCount

Return

The function returns a numeric value indicating how often DispEnd() must be called to make buffered screen output visible.

Description

DispCount() is used to determine the number of DispEnd() calls required with nested DispBegin() calls. Buffered screen output becomes only visible, when the number of DispEnd() calls matches exactly with the number of DispBegin() calls.

Info

See also:	DispBegin(), DispEnd(), DispOut()
Category:	Screen functions
Source:	rtl\gt.c
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// The example uses a typical coding pattern for DispCount() that
// forces buffered screen output to become visible.

   <code for buffered screen output with DispBegin()>

   DO WHILE DispCount() > 0
      DispEnd()
   ENDDO