xHarbour Reference Documentation > Function Reference

ClearSlow()

Clears a screen area incrementally with a delayed imploding effect.

Syntax

ClearSlow( <nDelay>  , ;
          [<nTop>]   , ;
          [<nLeft>]  , ;
          [<nBottom>], ;
          [<nRight>] , ;
          [<xChar>]    ) --> cNull

Arguments

<nDelay>

This is a numeric value specifying the number of milliseconds the function waits for the next incremental clearing step.

<nTop> and <nLeft>

Numeric values indicating the screen coordinates for the upper left corner of the screen area to clear. The default value for both parameters is zero.

<nBottom>

Numeric value indicating the bottom row screen coordinate. It defaults to MaxRow().

<nRight>

Numeric value indicating the right column screen coordinate. It defaults to MaxCol().

<xChar>

This is a single character or its numeric ASCII code. It is used for clearing the screen and defaults to the return value of GetClearB().

Return

The return value is always a null string ("").

Info

See also:	@...CLEAR, SetClearB()
Category:	CT:Video , Screen functions
Source:	ct\screen3.prg
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// The example displays a box and shows the imploding effect
// of ClearSlow().

   #include "Box.ch"

   PROCEDURE Main
      CLS

      DispBox( 5, 5, 20, 75, B_SINGLE+ " ", "W+/B" )
      WAIT

      ClearSlow( 20, 5, 5, 20, 75, " " )
   RETURN