Inserting a MessageCheckBox

To insert a messageCheckBox component:

In the Design Structure Window of the desired file, locate the node in which you wish to insert a messageCheckBox component.
In the Component Palette, select Form Components from the dropdown list, and then drag and drop the messageCheckBox component to the parent node of your choice.
The messageCheckBox node is inserted and highlighted under the expanded parent node.
In the Property Inspector, set the following attributes for the messageCheckBox component:
- text - Enter the text that displays after the checkbox.
- name - (Required) Enter a name for the checkbox. The name is used to identify the component in client-server or client-client events.
- checked - Select true to display a check mark in the box, indicating that the checkbox is currently checked. Default is false.
- prompt - Enter the prompt text that displays before the checkbox.
- value - Enter the string value to send when the checkbox is selected.
- primaryClientAction - Enter the client action to fire on the client. 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.
- selectedValue - Enter the string value for this checkbox. When this string value is the same as the value attribute, this attribute overrides the checked attribute. The checkbox then behaves as if the checked attribute is true.
- textAndAccessKey - To set both the text and an access key, use the ampersand ('&') notation. For example, setting this attribute to "T&ext" will display the text as"Text" and set the access key to 'e'.
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)


...
<messageCheckBox messageType="info"
                 prompt="Using a coupon?"
                 anchor="couponAnchor"
                 name="mcb1"
                 text="Enter coupon number here"/>
...