xHarbour Reference Documentation > Function Reference

SayMoveIn()

Outputs a string on the screen using a "move in" effect.

Syntax

SayMoveIn( <cString>
          [<nDelay>], ;
          [<nRow>]  , ;
          [<nCol>]  , ;
          [<lRight>]  ) --> cNull

Arguments

<cString>

A character string being displayed incrementally in the specified row.

<nDelay>

This is a numeric value specifying the number of milliseconds the function waits for the next incremental display. It defaults to 4 milliseconds.

<nRow>

A numeric value indicating the screen row for display. It defaults to Row().

<nCol>

A numeric value indicating the screen column for display. It defaults to Col().

<lRight>

If .T. (true) is passed, the string is displayed incrementally from the right. The default is .F. (false), which displays <cString> from the left.

Return

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

Note:  the function leaves the cursor position unchanged.

Info

See also:	SaveCursor(), SayDown(), SaySpread()
Category:	CT:Video , Screen functions
Source:	ct\screen3.prg
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// The example demonstrates the two output effects of SayMoveIn().

   PROCEDURE Main
      CLS

      SayMoveIn( "xHarbour compiler", 10, 2, 20, .F. )

      SayMoveIn( "xHarbour compiler", 10, 4, 20, .T. )
   RETURN