SCREEN SCROLL_WINDOW_AREA

SCREEN SCROLL_WINDOW_AREA scrolls a rectangular area of a specified window a specified number of rows. The minimum scrolling region is two rows.

SYNTAX

SCREEN SCROLL_WINDOW_AREA /USING/ window_id start_row start_column number_of_rows number_of_columns direction count

window_id

is an integer system field, Global Storage (GS) field, or user-defined field that contains the window ID assigned to the window.

start_row

is an integer expression that specifies the first row of the scrolling region.  If zero, row 1 of the window is used.

start_column

is an integer expression that specifies the first column of the scrolling region.  If zero, column 1 of the window is used.

number_of_rows

is an integer expression that specifies the number of rows in the scrolling region.  If zero, this value defaults to either the height of the scrolling region (if set with SET_WINDOW_SCROLL_REGION) or the height of the window.

number_of_columns

is an integer expression that specifies the number of columns in the scrolling region.  If zero, this value defaults to either the width of the scrolling region (if set with SET_WINDOW_SCROLL_REGION) or the width of the window.

direction

specifies the direction of the scroll.  The valid values are:

  • @UP moves the window in an upward direction.
  • @DOWN moves the window in a downward direction.

count

is an integer expression that specifies the number of lines to scroll.  If zero, one line is scrolled.

EXAMPLE

SCREEN SCROLL_WINDOW_AREA USING MAIN_ID 5 1 10 40 @DOWN 2

This example scrolls a 5 row and 40 column area in the MAIN_ID window.  The scroll starts in row 5, column 1 and scrolls down 2 lines.

SEE ALSO:  SCREEN SET_WINDOW_SCROLL_REGION (later in this section).

Back to Statements and Commands    Next page SCREEN SET_CURSOR_ABS