SCROLL statement

Purpose

Scroll all or part of the current console page.

Syntax

SCROLL [UP | DOWN | LEFT | RIGHT] [lines [, y1, x1[, y2, x2]]]

Remarks

y1 and x1 define the upper left corner of the region to scroll, while y2 and x2 define the lower right corner.  If neither are specified, the entire page is scrolled.

lines specifies the number of rows/columns to scroll, with a default value of one.

If a direction (UP, DOWN, LEFT, RIGHT) is not specified, DOWN is presumed.  The direction clause is considered to be the "source" of the scrolling.

For example, SCROLL DOWN means that a blank space is opened at the bottom of the scroll region, with remaining text moved up.  SCROLL LEFT means that a blank space is opened at the left of the scroll region, with remaining text moved right.

See also

SCREEN, SCREENATTR, SCREENX, SCREENY

Example

' Open one line at the bottom, scroll the

' rest of the page up one line

SCROLL 1

 

' Leave the last row unchanged, open 1 row

' at the top, shift the remainder down.

SCROLL UP 1, 1, 1, SCREENY-1, SCREENX

 

' Leave the first row unchanged, open 1 row

' at the bottom, shift the remainder up.

SCROLL DOWN 1, 2, 1