xHarbour Reference Documentation > Function Reference

CharWin()

Replaces characters in a specified screen area.

Syntax

CharWin( [<nTop>]    , ;
         [<nLeft>]   , ;
         [<nBottom>] , ;
         [<nRight>]  , ;
         [<xNewChar>], ;
         [<xOldChar>]  ) --> cNull

Arguments

<nTop> and <nLeft>

Numeric values indicating the screen coordinates for the upper left corner of the screen area. 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().

<xNewChar>

This is a single character or its numeric ASCII code. It replaces <xOldChar> and defaults to the return value of GetClearB().

<xOldChar>

This is a single character or its numeric ASCII code to be replaced on the screen. If omitted, all characters displayed on the screen are replaced.

Return

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

Info

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

Example

// The example displays a box of "A" and replaces it with "B"

   PROCEDURE Main
      CLS
      DispBox( 10, 10, 20, 20, "A" )

      WAIT
      CharWin( 10, 10, 20, 20, "B", "A" )

   RETURN