Use a PickerView widget to enable a user to select a single combination of values from multiple sets of values. A user rotates through each set of values with a selection indicator. For example, a user can select a single date from lists of months, days of the month, and years.
To learn how to use this widget programmatically, refer VoltMX Iris Widget guide.
Note: The PickerView widget is not available on SPA platforms.
Look properties define the appearance of the widget. The following are the major properties you can set:
- Whether the widget is visible.
- The platforms on which the widget is rendered.
- How the widget aligns with its parent widget and neighboring widgets.
- If the widget displays content, where the content appears.
For descriptions of the properties available on the Look tab of the Properties pane, see Look.
Skin properties define a skin for the widget, including background color, borders, and shadows. If the widget includes text, you can also specify the text font.
For the PickerView widget, you can apply a skin and its associated properties for the following states:
|Normal||The default skin of the widget.|
|Focus||The skin applied when the widget has the focus.|
For more information about applying skins, see Understanding Skins and Themes.
PickerView properties specify properties that are available on any platform supported by Volt MX Iris, and assign platform-specific properties.
Specifies the values displayed in the PickerView widget.
To specify values, click the Edit button to open the PickerView Master Data dialog box.
Specify key and display values for each component in the PickerView. Each component represents a set of data; for example, years and months. You can add a component or a key/value pair by clicking the appropriate + button.
Note: The combined component width should total 100 percent.
For the Android platform, specifies the picker view type.
The following are the options:
- Flat: The picker appearance is flat.
- Wheel: The picker displays as a wheel.
For the Windows 8 platform, specifies whether data is cached relative to the PickerView widget.
Actions define what happens when an event occurs. On a PickerView widget, you can run an action when the following event occurs:
- onSelection: The action is triggered when the component selection changes.
- onTouchStart: The action is triggered when the user touches the touch surface. This event occurs asynchronously.
- onTouchMove: The action is triggered when the touch moves on the touch surface continuously until movement ends. This event occurs asynchronously.
- onTouchEnd: The action is triggered when the user touch is released from the touch surface. This event occurs asynchronously.
For more information, see Add Actions.
Placement Inside a Widget
The following table summarizes where a PickerView widget can be placed:
|Scroll Box||Horizontal Orientation - YesVertical Orientation- Yes|
|Template||Header- NoFooter- No|
Widget Appearance on Platforms
The appearance of the PickerView widget varies as follows