(System Library)
Description: This module draws a horizontal scrollbar and returns its position.
Returns: Boolean
Usage: Steady State.
Format: \System\HScrollBar(Left, Top, Width, Steps, PageLen, Offset)
Parameters: Left { numeric } { required } { no default }
Any numeric expression for the left side coordinate of the scrollbar.
Top { numeric } { required } { no default }
Any numeric expression for the top coordinate of the scrollbar.
Width { numeric } { required } { no default }
Any numeric expression for the width of the scrollbar in pixels.
Steps is any numeric expression giving the number of steps in the scrollbar.
PageLen { numeric } { required } { no default }
Any numeric expression giving the number of steps to jump per page.
Offset { numeric } { required } { no default }
A variable whose value gives the exported/imported scroll position.
Comments: This module is a member of the System Library, and must therefore be prefaced by \System\, as shown in "Format" above. If the application you are developing is a script application, the System variable must be declared in APPMOD.SRC and need not be prefaced by a backslash in the function call.
Steps can be calculated by subtracting the number of visible items from the total number of scrollable items, while PageLen is equal to the number of visible items.
Example:
\System\HScrollBar(VStatus(Self, 11) - VStatus(Self, 21) { Left },
VStatus(Self, 12) - 1 { Top },
VStatus(Self, 12) { Width },
Length - LinesVisible { Total steps },
LinesVisible { Steps in page },
Offset { Thumb tab pos });
See Also: