Micro Focus Visual COBOL 2.3 Update 2 for Eclipse (Windows) > Programming > Compatibility > Compatibility with RM/COBOL > RM/Panels > Writing Programs > Standard Runtime Functions > SET SCROLL BAR RANGE

SET SCROLL BAR RANGE

Execution

PERFORM RMP--SSR-PANELNAME

Description

This standard runtime function changes the minimum, maximum, step, and page values for a scroll bar. In some instances, these values are unknown until the RM/Panels runtime system and this function can be used to reset them.

Required Parameters

The application program must set the name of the scroll bar in RMP--FIELD-NAME.

RMP--SB-MIN must be set to the new minimum value. RMP--SB-MAX must be set to the new maximum value.

Optional Parameters

RMP--SB-STEP may be set to the new step value or zero to keep the current value. RMP--SB-PAGE may be set to the new page value or zero to keep the current value.

Additional Usage Notes

This standard runtime function always sets the minimum and maximum value for a scroll bar.
If RMP--SB-STEP is set to 0, the step value is not changed. If RMP--SB-STEP is set to any non-zero value, that value becomes the new step value.
If RMP--SB-PAGE is set to 0, the page value will not be changed. If RMP--SB-PAGE is set to any non-zero value, that value will become the new page value.
The scroll bar thumb needs special consideration when resetting the scroll bar range. To avoid the possibility of having two scroll bar thumbs displayed simultaneously, always do the following before using this standard runtime function.
Set the scroll bar value to the minimum.
Display the scroll bar with the DISPLAY FIELD standard runtime function.

RMP--STATUS Values

Status value	Description
0	The function executed successfully.
1	The field/control name is invalid.
5	The panel is not in this library
6	The library does not exist.
14	A COBOL input/output error was encountered on the panel library during execution of this function. To determine the exact nature of the I/O error, use the C$RERR subprogram.