List (Input)

This object allows the operator to select an entry from a list. The displayed value is determined by the "Value" attribute or a variable. Only the current value is displayed when the object is not being edited. A value of 255 means that no entry has been selected. Invalid indices are not permitted, but a variable can be set to an invalid value. If the list entry is empty, it remains visible and can be selected.

Attributes

AID
Attribute
Description
Object Id

Unique identifier of the object. This must be unique within the object pool (2 bytes, 0-65534).

Type

The type of the object.

Width

Width of the object in pixels.

Height

Height of the object in pixels.

Variable Reference

Reference to a Variable object from which the value is taken.

Value (Integer)

Index of the selected list item. 255 means that no item is selected.

Number of List Items

Number of following object references. The size of the list must never exceed this number, and this attribute cannot be changed.

Options 2

Logical bits indicating options.

1 = TRUE.
Bit 0 = Enabled. If TRUE, the object is enabled. If FALSE, the object is disabled.
Bit 1 = Real-time editing. (VT Version 4 and later) If TRUE, the value is transmitted to the Working Set Master while it is being changed (see real-time in section 4.2).

Number of Macros to follow

Number of contained macro references, even if it is zero.

Each macro reference consists of 2 bytes: one for the event Id and one for the macro Id.

When the specified event occurs, the associated macro is executed. VT version 5 and later: A reference to a macro with a 16-bit Object Id counts as 2 macro references in the context of this attribute.