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.
See Also