$Scrollist

Top Previous Next

The $Scrollist object enables parameter lists to be designed with standard objects in any form. In combination with the indexed variable addressing option, it is possible, for example, to enter the parameters for several axes on a single parameters screen page.

$Scrollist=<name> is used to define a list of objects that can then be scrolled within a rectangular area. In other words, the X and Y position of the objects of a scroll list are changed dynamically when the Scrollist object is called (see also #Scrollist=<name>). The definition of the scroll list positions the objects one above the other beyond the size of the screen. #Scrollist=<name> then displays the objects of the scroll list in the defined area. The number of visible objects is automatically calculated on the basis of the line height (Limit2) and the actual dimension.

Example

Object	Text/File	...	X	Y	DX	DY	...	Limit2
$Scrollist=scroll1		...	0	0	160	200	...	50
#Button	myButton1	...	0	0	100	50	...
#Button	myButton2	...	0	50	100	50	...
#Button	myButton3	...	0	100	100	50	...

DX,DY

Define the spread of the scrollable area. The RTS determines the spread automaticaly. Under some circumstances that doesn't work very well.

The option FixedSize tells the RTS to use DX and DY.

Limit1

Limit1 defines the column width in pixels.

Limit2

Limit2 defines the row hight in pixels.

Optionen:

VarValueToScrollX	If set, VarValue is linked to the horizontal scrollbar. Other wise it's linked to the vertical scrollbar.
FixedSize	If set, DX,DY defines the spread of the scrollable area. Otherwise it's calculated automatically by the RTS
VerticalRibbonLayout	The controls are lined up vertically Gaps, normally caused by switched off ( VarState) objects, are closed automatically by shifting the visible objects vertically together.
HorizontalRibbonLayout	The controls are lined up horizontally Gaps, normally caused by switched off ( VarState) objects, are closed automatically by shifting the visible objects horizontally together.
VerticalScrollBarAlwaysOn	Makes the vertical scrollbar to be always visible
HorizontalScrollBarAlwaysOn	Makes the horizontal scrollbar to be always visible

Advantage

Once a scroll list is defined, it can be integrated in any page with a single line. The position and the dimension of the scroll list is defined when the #Scrollist=<name> is called.

The number of lines of the scroll list is calculated automatically.

Difference to EPAM3

•	In EPAM3 the number of lines must be specified in Limit2.

•	In EPAM3 the scroll objects are defined within the page with the Scroll option.

•	The position of the objects is relative to the page. In EPAM4 the position is relative to the Scrollist object.

•	In EPAM3 only the visible objects are active. In EPAM4 all objects of the scroll list are always active, even if they are not visible (e.g. Limit actions).