Define Scroll Viewport Size

This Subprogram defines the Size (in Lines) of the Scroll Viewport used for Echoing User Input and Prompting etc.

Short Name Calling Sequence

STATUS = UISCVP(NLINES[,OLDLIN])

Long Name Calling Sequence

STATUS = UI_SCROLL_VIEWPORT(...)

Input Arguments

NLINES (Integer) No. of Lines

Output Arguments

OLDLIN (Integer) Old No. of Lines (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_MODE ) Illegal Operation Mode UIILMD ) (ViewCursor Mode)

Note:

1. The Scroll Viewport is used for echoing of User Inputs and for using the normal Prompted Input Subprograms (UI_GET_xxx) during Viewport and Graphics Modes of Operation. It is setup by default to be 3 lines high for ViewText Mode of Operation, but may be resized via this Subprogram. An error will be reported if an attempt is made to setup a non-zero Scroll Viewport size in ViewCursor Mode.
2. A value for NLINES of Zero or less will inhibit the update of the Scroll Viewport, thus increasing the update efficiency for Viewport operations, but having the side-effect that normal FORTRAN output may corrupt the screen image. Subprogram UI_REPAINT_SCREEN may be used to repaint the complete screen image if this occurs.
3. The NLINES Argument is optional and, if omitted, will cause the default UIPACK scroll region size (3 lines) to be setup.
4. The OLDLIN Argument is optional and, if present, will be set to the old size of the Scroll Viewport prior to this call.