[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
COLORWIN()
Exchanges particular attributes in a screen area
------------------------------------------------------------------------------
Syntax
COLORWIN([<nTopLine>], [<nLeftCol>],
[<nBottomLine>], [<nRightCol>],
[<cNewAttr|nNewAttr>], [<cOldAttr|nOldAttr>])
--> cNull
Arguments
<nTopLine> Designates the topmost line to begin processing. The
default is the cursor line.
<nLeftCol> Designates the leftmost column to begin processing. The
default is the cursor column.
<nBottomLine> Designates the bottommost line that is processed.
The default is the last screen line or window line.
<nRightCol> Designates the rightmost column to clear. The default
is the right screen border or window border.
<cNewAttr|nNewAttr> Designates the new attribute to replace the old
one. The default is the standard attribute CLEARA.
<cOldAttr|nOldAttr> Designates the old character to exchange. The
default is "exchange all attributes".
Returns
COLORWIN() always returns a null string.
Description
COLORWIN() exchanges all occurrences of <cOldAttr|nOldAttr>for the
<cNewAttr|nNewAttr> attribute, within a particular screen or window
area. The function operates in a similar way to COLORREPL(), except
with COLORWIN() you can define the screen area to work on.
The parameters <nTopLine> and <nLeftCol> define the row and column for
the top-left corner; <nBottomLine> and <nRightCol> define the row and
column for the bottom-right column.
Note
. If <cOldAttr|nOldAttr> is not specified, all attributes are
exchanged for <cNewAttr|nNewAttr>; if <cNewAttr|nNewAttr> is not
specified, the attributes are exchanged for CLEARA.
Examples
. Exchange attribute 7 (white on black) for 0 (black on black =
invisible) from the current cursor position to the end of the screen
area:
COLORWIN(0, 7)
. Exchange all attributes in the area from line 23, column 15 to
line 24, column 70 for the standard attribute CLEARA:
COLORWIN(23, 15, 24, 70)
. Replace all attributes for attribute 116 (red on white) in the
region from line 23, column 15 to line 24, column 70:
COLORWIN(23, 15, 24, 70, 116)
. Change the white on black display to black on white. You can
specify different parameters:
COLORWIN(23, 15, 24, 70, "0/7", "7/0")
. Mixed formats are also possible:
COLORWIN(23, 15, 24, 70, "0/7", 7)
See Also:
COLORREPL()
Introduction
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson