xHarbour Reference Documentation > Function Reference

UntextWin()

Removes all text characters from the screen.

Syntax

UntextWin( <nTop>         , ;
           <nLeft>        , ;
           <nBottom>      , ;
           <nRight>       , ;
           <xReplace>     , ;
           [<xExceptFrom>], ;
           [<cExceptTo>]    ) --> cNull

Arguments

<nTop>

A numeric value indicating the screen coordinate for the top row of the rectangular screen region to clear.

<nLeft>

A numeric values indicating the screen coordinate for the left column of the rectangular screen region to clear.

<nBottom>

A numeric value indicating the screen coordinate for the bottom row of the rectangular screen region to clear.

<nRight>

A numeric values indicating the screen coordinate for the right column of the rectangular screen region to save.

<xReplace>

This is a single character or its numeric ASCII code. It replaces all textual characters on the screen.

<xExceptFrom> and <xEceptTo>

These are two single characters or their numeric ASCII codes that mark the lower and upper boundary of characters to leave unchanged. The default is the range from Chr(176) to Chr(223). This excludes all graphical characters used for drawing boxes from being replaced.

Return

The function replaces all textual characters on the screen and returns a null string ("").

Note:  the function leaves the cursor position unchanged.

Info

See also:	ClWin(), ClearWin()
Category:	CT:Video , Screen functions
Source:	ct\untext.prg
LIB:	xhb.lib
DLL:	xhbdll.dll