CREATE VSCROLLBAR

PLBCMP GUI Only

The CREATE VSCROLLBAR statement initializes a VSCROLLBAR object variable. The statement format is:

	[label]	CREATE	[{parent};]{vscrollbar}={pos}:
			{min},{max},{shift}[,{property list}...]

Where:

label

Optional. A Program Execution Label.

parent

Optional. A previously created WINDOW or PANEL object variable or pointer to a WINDOW or PANEL object on which the object is created.

vscrollbar

Required. The name of a previously defined VSCROLLBAR object variable or pointer to a VSCROLLBAR object.

pos

Required. The screen position of the object given as: {top}:{bottom}:{left}:{right}.

min

Required. A Numeric Variable, an Expression, or a decimal constant defining the minimum value of the object when the slider box is at the top most position.

max

Required. A Numeric Variable, an Expression, or a decimal constant defining the maximum value of the object when the slider box is at the bottom most position.

shift

Required. A Numeric Variable, an Expression, or a decimal constant defining the number of units to move the slider box when the mouse is clicked with the scroll bar slide area or when the page up or page down key is used.

property list

Optional. One or more of the object properties.

Flags Affected: NONE

Note the following:

This object defines a standard scroll bar that is displayed in a vertical orientation.
When there is a routine associated with the VSCROLLBAR object, the routine is passed a nine (9) digit result. The low order eight (8) digits define the current location of the slider box and are within the range defined by {min} and {max}. The ninth digit of the result variable defines the action performed for the scroll bar that caused entry into the activation routine follows:

Value	Meaning
1	Line down using the down arrow.
2	Line up using the up arrow.
3	Page down using the page down key or clicking in the scrollbar area below the slide box.
4	Page up using the page up key or clicking in the scrollbar area above the slide box.
5	Slide box moved to a new location.
6	Movement ignored - already at minimum value.
7	Movement ignored - already at maximum value.

If the optional {parent} parameter is not specified, the default window is used.