[<<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