A script-enabled browser is required for this page to function properly.

Creating a List Item

To create a List item:

  1. In the Object Navigator, expand the desired block node.
  2. Click the Items node.
  3. Click Create in the toolbar.
    A new item with a default name is inserted under the Items node.
  4. Double-click the object icon next to the newly created item to display the Property Palette.
  5. Under the General node, set the Item Type property to List Item.
  6. Under the Physical node, set the Canvas property to the name of the desired canvas.

    Note: To display an item at runtime, you must assign it to a canvas.

  7. Specify the display style for the List by setting the List Style property (under the Functional node) to PopList, TList, or Combo Box. PopList is the default.
  8. Double-click the Elements in List property (also under the Functional node) to display the List Item Elements dialog, then enter the elements exactly as you want them to appear in the List item at runtime.

    Tip: To insert a new element in the List, press [Down] or [Insert Element]. To remove an element from the List, press [Remove Element].

    Note: As an alternative to defining List item values at design time, you can also add List elements individually at runtime by using the ADD_LIST_ELEMENT Built-in subprogram, or you can populate the List from a record group at runtime using the POPULATE_LIST Built-in. If you populate the List from a record group, be sure that the record group you are using to populate the List contains the relevant values before you call POPULATE_LIST. If the record group is a static record group, it will already contain the appropriate values. Otherwise, you should populate the group at runtime using one of the record group subprograms.

  9. Associate a value with each element in the List by entering the desired value in the List Item Value field, then click OK.
    The List Item Value field displays the value associated with the element currently highlighted in the List Elements column. The values you assign to each element must be compatible with the datatype (CHAR, NUMBER, or DATE) of the List item.

    Tip: To assign a Null value to an element, leave the List Item Value field blank.

    Note: The value for an element cannot be longer than the number of characters specified by the List item's Maximum Length property.

  10. You must specify how you want a List item to handle a fetched or assigned value that is not one of the values associated with a specific element. To do so, set the List item's Mapping of Other Values property, under the Functional node:

    Note: The Mapping of Other Values property applies only to List element values fetched from the database or assigned programmatically at runtime. When end users select an element, the value of the List item is always the value associated with that element--never an Other Value.

About List Items

About List Element Values

About List Item Initial Values

Specifying an Initial Value for a List Item

Manipulating List items at Runtime

POPULATE_LIST Built-in

About Record groups

POPULATE_GROUP Built-in