ClearWin() - clear an area of current window using attributes
 Clears an area
──────────────────────────────────────────────────────────────────────────────

 Syntax

     ClearWin([<nTop>], [<nLeft>], [<nBottom>], [<nRightl>],
         [<cAttr | nAttr>],  [<cChar | nChar>]) --> cNull

 Arguments

     <nTop> is the top line where clearing is to begin. The default value is
     taken from the current cursor position.

     <nLeft> is the left column from which clearing is to begin. The default
     value is taken from the current cursor position.

     <nBottom> is the bottom line to clear. The default value is taken
     from the bottom row coordinate from the current window or the
     application window if no other windows are open.

     <nRight> is the right column to clear. The default is take from
     either from the right column coordinate from the current window or the
     application window if no other windows are open.

     <cAttr | nAttr> is attribute used to clear. The default is CLEARA
     character.

     <cChar | nChar> is the character used to clear. The default is the
     CLEARB character.

 Returns

     ClearWin() always returns a null string, or "".

 Description

     ClearWin() clears a specified area of the current window or the
     application window if no other windows are open, as specified by the
     coordinates nTop, nLeft, nBottom, nRight.

 Notes

     ■  This function does not alter the cursor position.

 Examples

     ■  Clear from the cursor position to the end of the line with the
        default clear character and default clear attribute:

        ClearWin()

     ■  Do the same for the bottom row of the current window:

        ClearWin( MaxRow() )

     ■  Clear an area between line 23, column 15 and line 24, column
        70 on the application window:

        wSelect( 0 )                /// Select the Application window
        ClearWin(23, 15, 24, 70)


 Files:  Library is MRWINDOW.LIB.