ConScrollDown command

 

Usage:

ConScrollDown [Rows& [, Row1&, Col1& [, Row2&, Col2&]]]]

 

Legacy Syntax:

SCROLL UP [Rows& [, Row1&, Col1& [, Row2&, Col2&]]]

 

Pseudo-object Syntax:

CON.SCROLL.UP [Rows& [, Row1&, Col1& [, Row2&, Col2&]]]

 

Moves all or part of the character cells down on the active console page.

 

Unlike the ConSetPageView command, which moves the view-port over a screen buffer that is larger than the visible window, this command actually moves a block of character cells within the screen buffer, and so is not dependent on a screen buffer that is larger than the window.

 

The Rows& parameter specifies the number of rows to scroll, with a default value of one. Row1& and Col1& define the upper left corner of the region to scroll, while Row2& and Col2& define the lower right corner. If neither are specified, the entire page is scrolled.

 

In PB/CC, SCROLL DOWN moves a block of text UP, SCROLL UP, moves a block of text DOWN, SCROLL LEFT moves a block of text LEFT, and SCROLL RIGHT moves a block of text RIGHT. The opportunity has been taken to reverse the counter-intuitive usage of UP and DOWN, which is inconsistent with the more logical LEFT and RIGHT.

 

Conversion:

 

#IF %DEF(%PB_CC32)

  SCROLL UP Rows&, Row1&, Col1&, Row2&, Col2&

#ELSE

  ConScrollDown Rows&, Row1&, Col1&, Row2&, Col2&

#ENDIF

 

CON.SCROLL.UP or CONSOLE.SCROLL.UP may be substituted for SCROLL UP in programs written for PB/CC 6.

 

See Also: ConScrollUp, ConScrollLeft, ConScrollRight, ConSetPageView