Skip to content

Widgets

Widgets Actions

From the Widgets section of the list of actions available along the left column of the Action Editor, you can add any of the following four actions. Click an action for instructions on how to add it to an action sequence.

Action Property
Set Widget Property Alters a widget's property. The following are the properties that you can define: isVisible:This property defines whether you wanted a widget to appear in an application. text: This property allows you to update the text that is displayed on a widget. src: This property allows you to update an image to the Image2 widget.
Set Master Data Some widgets, such as CheckBoxGroup, ComboBox, DataGrid, RadioButtonGroup, PickerView, and Segment2, need to be configured with an initial set of options or data before they can meet the needs for which you're using them. This initial configuration is referred to as the widget's master data.
Set Widget Skin Modifies which skin is associated with the widget.
Set Map Location Assigns map coordinates to a Map widget.

Set Widget Property

To configure an action that sets a particular property for a widget, do the following:

  1. From the Project tab of the Project Explorer, select the widget you want to apply the action to. Once it’s highlighted on the Iris Canvas, right-click it, and then select one of the action sequences, such as onTouchStart. Doing so opens the Action Editor and creates an action sequence for you to configure.
  2. From the list of actions available along the left column of the Action Editor, click Set Widget Property from the Widget section. The action is added to the action sequence and is the current action of focus.
  3. In the properties pane of the Action Editor, from the Property drop-down list, select the property that you want to set. When you do so, that property's sub-properties display.
  4. Make changes to the sub-properties.
  5. For each additional widget property that you want to set for this action sequence, repeat steps 2 through 4.
  6. Save the action by pressing Ctrl+S.

Set Master Data

Some widgets, such as the CheckBoxGroup, ComboBox, DataGrid, RadioButtonGroup, PickerView, and Segment2, need to be configured with an initial set of options or data before they can meet the needs for which you're using them. For instance, a checkbox group needs to be configured with the correct number of options, their labels, and their initial setting (either checked or not checked). This initial configuration is referred to as the widget's master data.

Setting the master data is applicable only for certain widgets.

To configure an action that sets the master data for a widget, do the following:

  1. From the Project tab of the Project Explorer, select the widget you want to apply the action to. This widget needs to be capable of having master data set for it, such as a CheckBoxGroup. Once it’s highlighted on the Iris Canvas, right-click it, and then select one of the action sequences, such as onTouchStart. Doing so opens the Action Editor and creates an action sequence for you to configure.
  2. From the list of actions available along the left column of the Action Editor, click Set Master Data from the Widget section. The action is added to the action sequence and is the current action of focus.
  3. In the properties pane of the Action Editor, click Set Master Data.
  4. Configure the master data so that the data set of the widget contains the data you want as a result of the action.
  5. When you are finished, click OK.
  6. Save the action by pressing Ctrl+S.

Set Widget Skin

To configure an action that sets the skin of a widget, do the following:

  1. From the Project tab of the Project Explorer, select the widget you want to apply the action to. Once it’s highlighted on the Iris Canvas, right-click it, and then select one of the action sequences, such as onTouchStart. Doing so opens the Action Editor and creates an action sequence for you to configure.
  2. From the list of actions available along the left column of the Action Editor, click Set Widget Skin from the Widget section. The action is added to the action sequence and is the current action of focus.
  3. In the properties pane of the Action Editor, from the Skin  list, select whether the skin you select applies to the Skin or the focusSkin.
  4. From the Theme list, select the theme you want to use.
  5. Select the skin you want from the list of available skins. The quantity and names of the skins listed depend on whether or not you have already created skins.
  6. Save the action by pressing Ctrl+S.

Set Map Location

The Set Map Location action applies only to the Map widget, and gives you the ability to set a map location, label, and description in response to an event.

To configure an action that sets the map location for a Map widget, do the following:

  1. From the Project tab of the Project Explorer, select the widget you want to apply the action to. Once it’s highlighted on the Iris Canvas, right-click it, and then select one of the action sequences, such as onTouchStart. Doing so opens the Action Editor and creates an action sequence for you to configure.
  2. From the list of actions available along the left column of the Action Editor, click Set Map Location from the Widget section. The action is added to the action sequence and is the current action of focus.
  3. In the properties pane of the Action Editor, in the Latitude text box, enter the latitude coordinate for the location.
  4. In the Longitude text box, enter the longitude coordinate for the location.
  5. In the Name text box, enter the name of the location that you want the user to see.
  6. In the Desc text box, enter the description of the location that you want the user to see.
  7. Save the action by pressing Ctrl+S.