WINDOW SCROLL

Scrolls an open window horizontally or vertically under application program control.

Syntax

WINDOW SCROLL [window] action

Parameters

window

Window can be
name
The name of the window that you want to open. The software looks up name in the currently accessed directories in the usual way. A compiled WINDOW OPEN command using name contains the unambiguous name of the window (including a reference to an application directory) that was found at compile time.
(expr )
A character string, or an expression that evaluates to a character string, that is to be used at run time as the name of the window. The parentheses must be entered.
A compiled WINDOW OPEN command using (expr) can refer to many windows, at the risk of encountering an ambiguous window name (i.e., no directory specified when versions of the window are available in two or more directories).
WINDOW OPEN cannot be used to open a window defined in a foreign directory.

action

Can be
TO row col
UP n | DOWN n
LEFT n | RIGHT n
PAGEUP | PAGEDOWN
JUMPUP | JUMPDOWN
JUMPLEFT | JUMPRIGHT
HOME | END
In TO row col, row and col are integers or expressions that evaluate to integers. Complex expressions must be enclosed in parentheses. Row identifies the character row at which the top of the client area is to be positioned; col identifies the character column at which the left side of the client area is to be positioned. Valid values are 1 through the maximum number of rows or columns in the current window's presentation space. A value of -1 for row or col indicates that no scrolling is to occur.

 

SCROLLING ACTION

SCROLL DIRECTION AND MAGNITUDE

UP n

In UP n, n is a number or an expression that evaluates to an number. Scrolls the window n rows up over its presentation space.

DOWN n

In DOWN n, n is a number or an expression that evaluates to an number. Scrolls the window n rows down over its presentation space.

LEFT n

In LEFT n, n is a number or an expression that evaluates to an number. Scrolls the window n columns left over its presentation space.

RIGHT n

In RIGHT n, n is a number or an expression that evaluates to an number. Scrolls the window n columns right over its presentation space.

PAGEUP

PAGEUP scrolls the window one client-area-height up over its presentation space.

PAGEDOWN

PAGEDOWN scrolls the window one client-area-height down over its presentation space.

PAGELEFT

PAGELEFT scrolls left the current width of the client area.

PAGERIGHT

PAGERIGHT scrolls right the current width of the client area.

JUMPUP

JUMPUP scrolls the window one half a client-area-height up over its presentation space.

JUMPDOWN

JUMPDOWN scrolls the window one half a client-area-height down over its presentation space.

JUMPLEFT

JUMPLEFT scrolls the window one half a client-area-width left over its presentation space.

JUMPRIGHT

JUMPRIGHT scrolls the window one half a client-area-width right over its presentation space.

HOME

HOME matches the top, left-hand corner of the client area to the top, left-hand corner of the presentation space.

END

END matches the bottom, right-hand corner of the client area to the bottom, right-hand corner of the presentation space.

Note: In all cases, n is a number, or an expression that evaluates to a number, indicating the number of character rows or character columns to scroll in the specified direction.

Comments

Under program control, the WINDOW SCROLL command scrolls the client area of the current window over its presentation space to enable the application user to see a part of the window contents that was not visible. The scrolling action occurs just as if the application user had initiated the same action.

 

Related Topics