Inserting a MessageRadioSet

To insert a messageRadioSet:

In the Design Structure Window of the desired file, locate the node in which you wish to insert a messageRadioSet component.
In the Component Palette, select Form Components from the dropdown list, and then drag and drop the messageRadioSet component to the parent node of your choice.
The messageRadioSet node is inserted and highlighted under the expanded parent node.
In the Property Inspector, set the following attributes for the messageRadioSet component:
- name - (Required) Enter a name for the component.
- prompt - Enter the prompt text that displays before the component.
- primaryClientAction - Enter the clientAction to fire. In the right column, click the icon to enter a ClientAction. See Editing the PrimaryClientAction Attribute for details. Alternatively, use the Advanced tab to enter an EL syntax data binding expression or use the Bind to Data dialog to select a data source for this complex attribute.
- selectedIndex - Enter the index of the globally selected option.
- selectedValue - Enter the value of the globally selected option.
- selection - Enter the selection information for this container.
In the Design Structure Window, right-click the messageRadioSet node and choose Insert inside messageRadioSet | option.
The option node is inserted and highlighted under the expanded messageRadioSet node.
In the Property Inspector, set the following attributes for the option component (radio button):
- text - Enter the option text to display next to the radio button.
- selected - Select true to indicate that this radio button is currently selected. Default is false. This attribute takes precedence over the selectedIndex attribute of messageRadioSet.
- 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 radio buttons.

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

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

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)


...
<messageRadioSet prompt="State"
                 messageType="info"
                 message="California is the sunny state."
                 selectedValue="CA"
                 name="mrs1">
  <contents>
    <option text="Alabama" value="AL" />
    <option text="Alaska" value="AK" />
    <option text="Arizona" value="AZ" />
    <option text="Arkansas" value="AR" />
    <option text="California" value="CA" />
    <option text="Colorado" value="CO" />
    ...
  </contents>
</messageRadioSet>
...