Inserting a MessageList

To insert a messageList component:

In the Design Structure Window of the desired file, locate the node in which you wish to insert a messageList component.
In the Component Palette, select Form Components from the dropdown list, and then drag and drop the messageList component to the parent node of your choice.
The messageList node is inserted and highlighted under the expanded parent node.
In the Property Inspector, set the following attributes for the messageList component:
- prompt - Enter the prompt text that displays before the text field.
- name - (Required) Enter a name for the component.
- multiple - Select true to allow multiple items to be selected.
- size -Enter the number of items that should be visible.
- selectedIndex - Enter the index of the globally selected option. Use one of the following values:
  - 0 - make the first option selected
  - 1 - make the second option selected
  - 2 - make the third option selected, and so on
- selectedValue - Enter the value of the globally selected option.
- selection - Enter the selection information for the option container.
In the Design Structure Window, right-click the messageList node and choose Insert inside messageList | option.
The option node is inserted and highlighted under the expanded messageList node.
In the Property Inspector, set the following attributes for the option component:
- text - Enter the item text to display in the list box.
- selected - Default is false. Select true to display this item text as selected in the list box. For single selection list boxes, this attribute takes precedence over the selectedIndex attribute of messageList.
- value - Enter the value that identifies this item when the parent component is submitted to the server.
Repeat steps 4 and 5 to add the desired number of options.

Tip: For an option to be rendered as selected, ADF UIX uses these attributes in this order of precedence: selection attribute on option container, selected attribute on option component, selectedValue attribute on option container, selectedIndex on option container.

Note: To use data binding, see Data Binding a Component Attribute.

For information about message attributes, see Setting the Message Attributes for a Message Form Component. For information about other general attributes of message form components, see Setting the General Attributes for a Message Form Component.

Example (UIX XML)


...
<messageList name="mylist"
             multiple="true"
             prompt="Choose your options:">
  <contents>
    <option text="Option1" value="val1"/>
    <option text="Option2" value="val2"/>
    <option text="Option3" value="val3"/>
  </contents>
</messageList>
...