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.