[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
CLWIN()
Clears character and attribute from a screen area
------------------------------------------------------------------------------
Syntax
CLWIN([<nTopLine>], [<nLeftCol>], [<nBottomLine>],
[<nRightColumn>]) --> cNull
Arguments
<nTopLine> Designates the topmost line where clearing should begin.
The default is the cursor line.
<nLeftCol> Designates the leftmost column where erasure should
begin. The default is the cursor column.
<nBottomLine> Designates the bottommost line to clear. The default
is the last screen line or window line.
<nRightColumn> Designates the rightmost column to clear. The
default is the right screen border or window border.
Returns
CLWIN() always returns a null string.
Description
Implement CLWIN() when you need to clear to black without the use of the
standard attribute and character. This function is helpful when you use
a monochrome video card. A significant advantage of CLWIN() over
CLEARWIN(), is the omission of the <cAttr|nAtt> and
<cCharacter|nCharacter> parameters, because it increases the speed of
CLWIN(). The function is faster because it does not note the CLEARA and
CLEARB settings.
CLWIN() has some advantages over the Clipper @ Row, Column commands:
1. This function takes the returned value of the character string type
and combines it with string outputs (e.g., LIST...CLWIN()).
2. The cursor position is not affected.
3. The parameters are optional. If they are not specified, the function
clears from the current cursor position.
Note
. If no parameters are specified for the line or column, the
function automatically orients itself to the current cursor position.
Examples
. Clear from the cursor position to the end of the screen area:
CLWIN()
. Do the same from the current cursor position in line 23:
CLWIN(23)
. Clear from line 23, column 15, to the end of line 24:
CLWIN(23, 15, 24)
. Clear a window between line 23, column 15, and line 24, column
70:
CLWIN(23, 15, 24, 70)
See Also:
CLEAREOL()
CLEARWIN()
CLEOL()
Introduction
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson