ClearEOL() - Clears to end of current line using attributes
Clears from the cursor position to the end of line
──────────────────────────────────────────────────────────────────────────────

Syntax

ClearEOL([<nRow>], [<nCol>], [<cAttr | nAttr>], [<cChar | nChar>])
--> cNull

Arguments

<nRow> is the line to be cleared. The default is the current line.

<nCol> is the column to start from. The default is the current column.

<cAttr | nAttr> is the attribute used to clear. The default is "W/N"
or 7.

<cChar | nChar> is the character used to clears. Default is CHR(255)

Returns

ClearEOL() always returns a NULL string, or "".

Description

ClearEOL() may be used to clear a specific line, using a specific
colour, from a given position to the end of the line without affecting
the Clipper ROW() or COL() functions.

If you do not specify a colour attribute character, [<cAttr | nAttr>],
then CLEARA is used.

If you do not specify a character to clear with, [<cChar | nChar>],
then CLEARB is used.

Notes

■ If a window is currently selected, the this function will be applied
to the window.

■ If no parameters are used the current line will be cleared from the
current cursor position to the end of the line.

■ This function does not alter the cursor position.

Examples

■ Clear from the cursor position to the end of the line assuming a
default colour character of "W/N", starting at the current cursor
position.

ClearEOL()

■ Do the same for bottom of the current window or application window
from the current cursor position:

ClearEOL( MaxRow() )

■ Clear the bottom of the current window, but begin at 10 chars from the end:

ClearEOL( MaxRow(), MaxCol()-10 )

■ The attributes can be specified in different ways:

ClearEOL( MaxRow(), MaxCol()-10, 4 ) // red on black
ClearEOL( MaxRow(), MaxCol()-10, "4,7" ) // red on white
ClearEOL( MaxRow(), MaxCol()-10, "B/W" ) // blue on white

■ Clear with special attribute and character:

ClearEOL( MaxRow(), MaxCol()-10, "3/1", ":" )
ClearEOL( MaxRow(), MaxCol()-10, "3/1", "+" )

Files: Library is MRWINDOW.LIB.