DATALIST

PLBCMP GUI Only

The DATALIST instruction defines an object variable for a standard GUI scrolling list. Use a DATALIST to display a scrollable list of items from which the user can select, add, or delete. To define a DATALIST, use one of the following statement formats:

(1)	[label]	DATALIST	[%]
(2)	[label]	DATALIST	(arraysize)
(3)	[label]	DATALIST	^
(4)	[label]	DATALIST	^,{target}
(5)	[label]	DATALIST	^(arraysize)
(6)	[label]	DATALIST	^(arraysize),({target}),...,({target})

Where:

label

Optional. A Data Label.

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

A DATALIST contains as many items as there are lines in the list. Each member of the list is one item.
The entire DATALIST is referenced as item number zero.
Items are accessible through the SETITEM or GETITEM instructions.
The value of a DATALIST is the item of the list that is currently selected.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes a Pointer Variable.
Although a DATALIST may be defined as Global, it is DESTROYed during a CHAIN instruction.
When using the PL/B Web Server, the DATALIST on tablets and phones behaves like a COMBOBOX.