Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

  ◄Syntax►  ◄Details►  ◄Example►                 ◄Contents►  ◄Index►  ◄Back►
──────────────────────────────────────────────────────────────────────────────
CLS [{0 | 1 | 2}]
 
    ■ 0    Clears the screen of all text and graphics, except the
           bottom line of text; returns the cursor to the home position.
    ■ 1    Clears the graphics viewport; may or may not clear the
           bottom line of text or return the cursor to home.
    ■ 2    Clears the text viewport; leaves the bottom screen line
           unchanged and returns the cursor to home.
    ■ If no argument is used:
        - If the screen mode is 0, then clears the text viewport, except
          the bottom line of text, and returns the cursor to home.
        - In any other screen mode, the graphics viewport will be cleared;
          may or may not clear the bottom line of text or return the
          cursor to home.
 
    ■ To return the text cursor to home is to move it to the upper-left
      corner of the screen.
    ■ In some cases, the bottom line of text is untouched by the CLS
      statement; in other cases, it is regenerated.
 
See Also    ◄VIEW►    ◄VIEW PRINT►    ◄WINDOW►