Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

VAXTPU SCROLL — VMS 5.2

 SCROLL

 Scrolls text in the current buffer up or down on the screen by the number
 of lines specified.  The cursor stays at at the same relative screen
 location.

 Syntax

    [integer1 :=] SCROLL (window [,integer2])

 Parameters

    window     The window associated with the buffer whose text you want to
               scroll.

    integer    The number of lines you want the text to scroll.  Positive
               values cause the text to scroll up (toward the top of the
               screen).  Negative values cause the text to scroll down
               (toward the bottom of the screen.) If you specify 0, no
               scrolling occurs.

 Comments

 The current character position will be different from the character
 position that was current before you issued the SCROLL built-in.

 SCROLL optionally returns (integer1) the number and direction of lines
 actually scrolled:  A negative value indicates the number of lines
 scrolled up; a positive value indicates the number of lines scrolled down.
 (This value may be different from what you specified in integer2.)

 If you omit integer2, the text is scrolled in the current direction of the
 buffer until you press a key.  Commands or procedures bound to that key
 are executed.  In forward direction, scrolling continues until the end of
 the buffer or a key press; in reverse direction, until the beginning of
 the buffer or a key press.

 Examples

 1.  SCROLL (main_window, +10);

     Scrolls text up 10 lines.

 2.  SET (FORWARD, my_buffer);
     SCROLL (my_window);

     Scrolls up the text in MY_BUFFER (mapped to MY_WINDOW) until the end
     of the buffer is reached or until you a key is pressed.

 Related topics

    SET(CROSS_WINDOW_BOUNDS)   SET(FORWARD)   SET(REVERSE)   SET(SCROLLING)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026