Clich here for an overview of the differences and similarities between the various components that provide selection list and input box capabilities.
|
| The Long List component offers a facility to select a value from a
pre-defined set of possible values. Clich here for an overview of the differences and similarities between the various components that provide selection list and input box capabilities. |
The Long List is designed to manipulate a larger number of entries than the standard list box. Controls are supplied at the side of the long list box for moving up and down the list in small and large steps.
The long list also allows multiple selections from the items listed.
Hint: If the list of possible values is "only two possible values", a Check Box might be preferrable. When the list is up to five, the Radio Button is probably the best approach. Up to a couple of dozen, the List Box or Drop Down List is the best way, and if the list is even longer, the Long List Box is to be preferred.
The events that are recognized for components of the type LongList are: Choose, Create, Destroy, Enter, Exit, Scroll, change, dblClick, deselect, goBottom, goDown, goDownBig, goTop, goUp, goUpBig, gotFocus, help, lostFocus and select.
The default property for a long list is Value.
The property list for a long list is:
| Property Name (MSM-Workstation) | Property Name (MWAPI) | Default Value | Value Range |
|---|---|---|---|
| Active | ACTIVE | Boolean value | |
| BackColor | BCOLOR | Color | |
| Cancel | CANCEL | Boolean value | |
| Changed | CHANGED | Boolean value | |
| ChoiceField | Field | ||
| ChoiceVar | Field | ||
| Container | Free text | ||
| DataField | Field | ||
| DisplayOnly | CANCHANGE | Boolean value | |
| FontBold | FSTYLE | Boolean value | |
| FontFace | FFACE | Font face | |
| FontItalic | FSTYLE | Boolean value | |
| FontSize | FSIZE | Font size | |
| FontUline | FSTYLE | Boolean value | |
| ForeColor | FCOLOR | Color | |
| MaxSelect | SELECTMAX | Positive integer numeric value | |
| Message | ZMESSAGE | Free text | |
| Name | Name of component (current window) | ||
| NextControl | NEXTG | Name of component | |
| Pointer | PTYPE | Pointer (extended) | |
| PosLeft | POS | Positive numeric value | |
| PosTop | POS | Positive numeric value | |
| PosUnits | POS | Unit Specification | |
| ScrollMax | SCROLLRANGE | Positive numeric value | |
| ScrollMin | SCROLLRANGE | Positive numeric value | |
| ScrollPosition | SCROLLPOS | Positive numeric value | |
| SizeHeight | SIZE | 40 | Positive numeric value |
| SizeUnits | SIZE | Unit Specification | |
| SizeWidth | SIZE | 40 | Positive numeric value |
| TBackColor | TBCOLOR | Color | |
| TFontBold | TFSTYLE | Boolean value | |
| TFontFace | TFFACE | Font face | |
| TFontItalic | TFSTYLE | Boolean value | |
| TFontSize | TFSIZE | Font size | |
| TFontUline | TFSTYLE | Boolean value | |
| TForeColor | TFCOLOR | Color | |
| TabStops | ZTABSTOPS | Tabulator stops | |
| Title | TITLE | [Title] | Free text |
| TitlePos | TPOS | Title position | |
| TopRow | TOPSHOW | Item in list of choices | |
| Type | TYPE | LONGLIST | Type of component |
| Units | UNITS | Unit Specification | |
| Value | VALUE | ||
| VarName | Name of variable | ||
| VarPermanent | Boolean value | ||
| Visible | VISIBLE | Boolean value | |
Go back to the alphabetic list of components.