Name: CLS Shortest: CLS
Family: Command Category: Programming
Description: Use the CLS command to clear the R> Prompt or application window, regardless of the current output device.

Syntax

CLS syntax diagram

Options

backcolor
Specifies the background color of the cleared area. Valid R:BASE background colors are black, blue, brown, cyan, green, gray, magenta, and red. In Windows you can also use yellow and white.

FROM scrnrow, scrncol
Specifies the first screen row to clear, starting at the column specified by scrncol.

TO scrnrow, scrncol
Specifies the last screen row to clear, ending at the column specified by scrncol.

About the CLS Command

CLS does not issue a form feed. (The NEWPAGE command does issue a form feed.)

Example

The following example clears the window from row 7 column 5 to row 9 column 60, and sets the background color in the cleared region to red.

CLS FROM 7,5 TO 9,60 RED