477
OPUS Projektor Manual
Object Reference
6.4.9
List
Tutorial video about the list object
https://www.youtube.com/watch?v=zNNjsMrO4Hk
The list object is a useful object to show other objects based on a value (e.g. two icons in a list
showing a different state).
A list always contains other objects. It is possible to either display only one object at a time or
multiple objects, this can even be defined for the different navigation states of the list (see
properties Items Visible (Normal Mode) and Items Visible (Editing Mode)). This makes it
possible to show something like a drop down menu (1 item visible in normal mode, more
visible in editing mode).
Note: At runtime the list object's height is automatically calculated based on the number of
currently displayed child items (and their item height). This also means that a list that has no
child items will NOT be displayed at all. In the designer the list is always shown in full height
based on the properties Items Visible (Normal Mode) or Items Visible (Editing Mode) even
if no or less children are present.
As with all other objects there are some common object properties that are also used by the
list object. Se here for a description of the common properties.
The list specific properties are listed below.
List Specific Properties
Item Height
The height of a list object can not be changed via the common Height property. The height of
the list is defined by a combination of the Item Height property, the Border Width (and Draw
Border) and the number of visible items items in the list (see Items Visible (Normal Mode)
and Items Visible (Editing Mode) below).
Use this property to define the height of each item (other object) in the list.
Default value: 30 pixel
Possible values: 1 ... 1280 pixel
List Item Mode
This property is only a preview for the two list modes that are available (normal or editing). It
has no effect on runtime behavior.
Note: This property can only be changed if the property Open For Input is enabled.
Default value: Normal
Possible values: Normal or Editing
Items Visible (Normal Mode)
With this property it can be defined how many items (or objects) are visible in normal mode of
the list (when it is currently not edited (not open for input)).
Default value: 1
Possible values: 1 ... 255
Items Visible (Editing Mode)
When a list is edited (made open for input by the user) it is possible to show more items than
in normal mode. Like this it is possible to create a drop down box that shows the user more
options.
415