WINDOW SCROLL
Move Data in Thoroughbred Basic Window
This directive enables, disables, and maintains the scrolling attributes of the currently active Thoroughbred Basic Window or designated IOREGION. It may be used to change the current setting of the scroll attribute or to force the currently active Thoroughbred Basic Window or IOREGION to scroll up, down, left, or right a specific number of rows or columns.
Syntax
Section titled “Syntax”WINDOW SCROLL ( ON )
WINDOW SCROLL ( OFF )
WINDOW SCROLL ( LEFT, col1 )
WINDOW SCROLL ( RIGHT, col1 )
WINDOW SCROLL ( UP, row1 )
WINDOW SCROLL ( DOWN, row1 )ON- is a keyword indicating that the scroll attribute for the currently active Thoroughbred Basic Window should be turned on. When scrolling is on, output past the bottom right cursor position of the Thoroughbred Basic Window causes the Thoroughbred Basic Window to roll up 1 row and the cursor to move to the bottom left cursor position of the Thoroughbred Basic Window.
OFF- is a keyword indicating that the scroll attribute for the currently active Thoroughbred Basic Window should be turned off. When scrolling is off, output past the bottom right cursor position of the Thoroughbred Basic Window causes the next cursor position to be at the top left of the Thoroughbred Basic Window.
LEFT- indicates that the Thoroughbred Basic Window or IOREGION will scroll to the left.
RIGHT- indicates that the Thoroughbred Basic Window or IOREGION will scroll to the right.
UP- indicates that the Thoroughbred Basic Window or IOREGION will scroll up.
DOWN- indicates that the Thoroughbred Basic Window or IOREGION will scroll down.
col1- is any positive integer in the range of 1 to the maximum number of columns in the Thoroughbred Basic Window or IOREGION, designating the total number of columns to scroll the text area.
row1- is any positive integer in the range of 1 to the maximum number of rows in the Thoroughbred Basic Window or IOREGION, designating the total number of rows to scroll the text area.
Remarks
Section titled “Remarks”This directive is generally available starting with release level 8.1.
If you use this directive but Thoroughbred Basic Windows is not enabled, an ERR=70 results. For information on how to enable Thoroughbred Basic Windows, please refer to the information on TCONFIG files and IPL files in the chapter on System Files in the Thoroughbred Basic Customization and Tuning Guide.
If this task is configured for Thoroughbred Basic Windows, only the standard set of Thoroughbred Basic terminal mnemonics should be used to send output to the terminal. Using direct hexadecimal escape sequences to control the terminal screen may cause the Thoroughbred Basic Windows Manager to lose knowledge of cursor position and character attributes. For more information on terminal mnemonics, please refer to the Thoroughbred Basic Customization and Tuning Guide.
All character positions vacated by scrolling are filled with normal video spaces.
Examples
Section titled “Examples”WINDOW SCROLL ( OFF )turns off the automatic scrolling of the currently active Thoroughbred Basic Window, if it was turned on.
WINDOW SCROLL ( LEFT, 10 )scrolls all rows in the currently active Thoroughbred Basic Window or IOREGION left by 10 columns.
WINDOW SCROLL ( UP, 12 )assuming a full-screen Thoroughbred Basic Window, causes the Thoroughbred Basic
Window to scroll up half the screen.
See also
Section titled “See also”Other WINDOW directives
Additional WIN functions
From the Thoroughbred Basic Language Reference, Volume III: R–Z, version 8.9.1. Open this page in the PDF