Combo Box
The Combo Box control allows you to create a drop-down list that can generate and run R script or Python for Spark script specific to the selected list item. It is limited to single selection. The Combo Box control has the following properties:
Identifier. The unique identifier for the control. This is the identifier to use when referencing the control in the script template.
Title.
An optional title that appears above the control. For
multi-line titles, use \n to specify line breaks.
Title Position. Specifies the position of the title relative to the control. Values are Top and Left where Top is the default.
ToolTip. Optional ToolTip text that appears when the user hovers over the control.
List Items. Click the ellipsis (...) button to open the List Item Properties dialog box, which allows you to specify the list items of the control. You can also open the List Item Properties dialog by double-clicking the Combo Box control on the canvas.
Mnemonic Key. An optional character in the title to use as a keyboard shortcut to the control. The character appears underlined in the title. The shortcut is activated by pressing Alt+[mnemonic key].
Editable. Specifies whether the Combo Box control is editable. When the control is editable, a custom value can be entered at run time.
Script. Specifies the R script or Python for Spark script that is generated by this control at run time and can be inserted in the script template.
- The value
%%ThisValue%%specifies the run time value of the control and is the default. If the list items are manually defined, the run time value is the value of the Script property for the selected list item. If the list items are based on a target list control, the run time value is the value of the selected list item. For multiple selection list box controls, the run time value is a blank-separated list of the selected items. See the topic Specifying list items for combo boxes and list boxes for more information.
- You can specify any valid R script or Python for Spark script. For multi-line scripts or long scripts, click the ellipsis (...) button and enter your script in the Script Property dialog.
%%ThisValue%% when the Script property contains %%ThisValue%% as
part of a quoted string. In this context, a quoted string is a string that is enclosed in single
quotation marks or double quotation marks. Quote handling applies only to quotation marks that are
the same type as the quotation marks that enclose %%ThisValue%%. The following
types of quote handling are available.-
- Python
- Quotation marks in the run time value of %%ThisValue%% that match the enclosing quotation marks
are escaped with the backslash character (\). For example, if the Script property is '%%ThisValue%%' and the run time value
of the combo box is
Combo box's value, then the generated script is'Combo box\'s value'. Note that quote handling is not done when %%ThisValue%% is enclosed in triple quotation marks. - R
- Quotation marks in the run time value of %%ThisValue%% that match the enclosing quotation marks
are escaped with the backslash character (\). For example, if the Script property is '%%ThisValue%%' and the run time value
of the combo box is
Combo box's value, then the generated script is'Combo box\'s value'. - None
- Quotation marks in the run time value of %%ThisValue%% that match the enclosing quotation marks are retained with no modification.
Enabling Rule. Specifies a rule that determines when the current control is enabled. Click the ellipsis (...) button to open the Enabling Rule dialog box and specify the rule. The Enabling Rule property is visible only when other controls that can be used to specify an enabling rule exist on the canvas.