You are here:
SelectionBox Control
The SelectionBox element defines a grouped set of elements that allows the user to make a selection, similar to a radio button group or checkbox group. It can include a title and is enclosed by a border or similar UI element to indicate to the user that it’s a logical unit.
Required Editions
| Available in: Enterprise, Performance, and Unlimited Editions |
The table lists the SelectionBox element attributes.
| Attribute | Description | Value or Pattern | Required? |
|---|---|---|---|
| name | Identifier of the SelectionBox control | string | yes |
| disabled | Specifies if the SelectionBox element is enabled or disabled. | boolean | no |
The SelectionBox element contains these child nodes
- Bindings
- Items
- Events
SelectionBox Bindings
The Bindings element consists of the Resource and Binding elements. The table lists the targets that are supported for the Resource and Binding elements in the SelectionBox element.
| Attribute | Description | Value or Pattern |
|---|---|---|
| target | Defines the path of the SelectionBox control. | string |
| type | Defines how the resource is shown. | string |
| binding | Source of the binding. | string |
| bindingMode | Binding mode is used to control the updating process. | string [One Way] |
| toggleId | Refers to the identifier of a domain. | string (domain) |
| defaultLabel | One default value can be set, depending on the type, that is, defaultText, defaultLabel, and defaultImage. | string |
| labelId | The ID that is used for mapping the localized resource and the actual element in the UI. | string |
SelectionBox Items
The SelectionBox Items node consists of the Item elements that can be used in the SelectionBox control element. The table list the attributes of the SelectionBox Items node.
SelectionBox Events
The SelectionBox Events consist of event elements that can be used in the SelectionBox control element.
| Event Name | Fired when | Required? |
|---|---|---|
| ItemSelectedEvent | A user taps any item in the SelectionBox. | No |
| SelectionChangedEvent | A user taps an item, which wasn’t selected before | No |
Sample XML code
SOURCE TYPE BINDING
<SelectionBox name="SelectionBoxCtrl" disabled="false">
<Bindings>
<Resource target="Label" type="Label" id="labelId" defaultLabel="defaultLabel" />
<Binding target="DataSource" binding="itemsBindingSource" bindingMode="TWO_WAY" />
<Binding target="Value" binding="valueBinding" bindingMode="TWO_WAY" />
</Bindings>
<Items>
<Bindings>
<Binding target="ItemValue" type="Text" binding="codeBinding" bindingMode="ONE_WAY" />
<Binding target="ItemText" type="Text" binding="textBinding" bindingMode="ONE_WAY" />
</Bindings>
</Items>
</SelectionBox>