CREATE HSCROLLBAR

PLBCMP GUI Only

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

	[label]	CREATE	[{parent};]{hscrollbar}={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.

hscrollbar

Required. The name of a previously defined HSCROLLBAR object variable or pointer to a HSCROLLBAR 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 scroll bar when the slider box is at the left most position.

max

Required. A Numeric Variable, an Expression, or a decimal constant defining the maximum value of the scroll bar when the slider box is at the right 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 horizontal orientation.
When there is a routine associated with the HSCROLLBAR 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 the activation routine as 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 - at minimum value.
7	Movement ignored - at maximum value.

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