[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 CHARWIN()
 Exchanges particular characters in a screen area.
------------------------------------------------------------------------------
 Syntax

     CHARWIN([<nTopline>,<nLeftcolumn>,<nBottomline>,
        <nRightcolumn>, [<cNewcharacter|nNewcharacter>],
        [<cOldcharacter|nOldcharacter>]]) --> cNull

 Arguments

     <nTopline>  Designates the line for the top-left corner of the area.

     <nLeftcolumn>  Designates the column for the top-left corner the
     area.

     <nBottomline>  Designates the line for the bottom-right corner of
     the area.

     <nRightcolumn>  Designates  the column for the bottom-right corner
     of the area.

     <cNewcharacter|nNewcharacter>  Designates the new character for the
     screen area.  Specify the parameter as a numeric in the range of 0 to
     255 or as a character string.  The default value is the CLEARB.

     <cOldcharacter|nOldcharacter>  Designates which character to
     exchange.  Specify the parameter as a numeric in the range of  0 to 255
     or as a character string.  The default is to exchange all characters.

     ()  When no parameter is designated, the function replaces all
     characters in the screen area with CLEARB.

 Returns

     The function always returns a null string.

 Description

     Within a screen area, CHARWIN() replaces all characters or just a
     particular character with a new one.  If <cNewcharacter|nNewcharacter>
     is not designated, the function uses the character set with SETCLEARB(),
     where the preset value is CHR(255).  The upper-left and lower-right
     corner rows and columns are given for the borders of the area.  If these
     arguments are missing, then the entire screen area is exchanged.

 Examples

     .  Exchange all characters for CLEARB:

        SETCLEARB("X")       // Exchanges within CHARWIN() entire screen

     .  Exchange all "A" for "B":

        CHARWIN(10, 10, 20, 70, "B", "A")    // Always returns a ("") null
                                             // string

     .  Numeric characters can also be designated:

        CHARWIN(10, 10, 20, 70, 66, 65)      // A = 65, B = 66


See Also: SETCLEARB() COLORWIN() Introduction
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson