Control Properties - Action Tab

This tab is used to define the action, or event, triggered when the control is selected. It is used to define actions for the following types of controls:

Bulleted list	Date picker	Input field	Pushbutton
Calendar	Drop-down list	List box	Spinner
Checkbox	HSlider	Numbered list	Toggle button
Combo box	Image	Plain text	VSlider

You can use this tab to define one of two types of actions:

A “system action” is a predefined event, such as closing a window or inserting a row. You select the specific action from the popup menu displayed when you add an action (click the (Add) button.
A “custom action” is a specialized action that you define, by choosing Custom action from the popup menu and entering the name for the action in the Action Name column of the new row.

The fields and controls of the tab change according to the type of action you define, and according to the specific option you chose for that type of action.

For each field and control, you can define a sequence of actions. To do so, add the actions to be executed for the control, and use the arrow buttons in the toolbar above the action list to arrange the actions in the proper sequence.

Structure

The following table describes the controls and fields that are displayed in the tab, according to your selection in the popup menu of system actions:

Control / Field	Action / Attribute	Description
Add		Add new action.
Delete		Delete selected action.
Move Up		Move action one up in sequence.
Move Down		Move action one down in sequence.
#		Number of sequence step.
Action Name		Name of either system or custom action.
	Assign	Enables the runtime user to choose a value from a field (Assigned expression) in one element (Apply to) and then assign it to a field (Target field) in another element (Target).
	Clear Form	Removes the values currently displayed in the input fields of an element. Useful, for example, in a Submit sequence of actions.
	Close Window	Closes the window (for example, a popup window).
	Delete Row	Deletes the current object and moves the cursor to the next object.
	Dynamic Action	Invokes a dynamic action, according to the given formula defined in the field in the Action Properties section.
	Export Data	At runtime, copies data to the Clipboard and displays a dialog box that lets the user choose to display the data according to column heading or field name. In charts, displays the data series, one table for each axis.: Export row Export element – Exports contents of entire view Export selected elements – Exports selected content Export window - Exports contents of entire window
	Export Data to Excel	Copies selected data to Clipboard and pastes it into a displayed Excel worksheet according to the following Action Properties: Export row Export element – Exports contents of entire view Export selected elements – Exports selected content Export window - Exports contents of entire window Note This features is available only with Windows Explorer. End of the note.
	Find Row	Looks for the next object in the dataset that matches the expression defined in the field in the Action Properties section. The search starts from the current cursor position until the end of the dataset, and then continues from the beginning back to the cursor position, in a cyclical manner.
	History Back	Navigates back one step through the target element’s history.
	Hyperlink	Opens the document at the URL address specified in the field in the Action Properties section.
	Insert Row	Inserts a new row and moves the cursor to the new object, selected according to the following Action Properties: Insert after Insert before Insert first Insert last
	Move Row	Moves to a new row position, selected according to the following Action Properties: Move after Move before Move first Move last
	Print	Sends the selected data to a printer according to the following Action Properties: Print element – Prints contents of view Print selected element – Prints selected contents of view Print window Print page
	Prompt	Displays the message defined in the field in the Action Properties section, in a modal dialog box.
	Select Element	Used “behind the scenes” to select a target element or dataset when the cursor is moved to that object.
	Select Row	Selects the object that corresponds to the specified row, and scrolls the dataset so that the row is brought into view. Selected according to the following Action Properties: First row Last row Next row Previous row Row number (selected from spinner)
	Show Page	Scrolls the dataset so that the specified page is brought into view, according to the following Action Properties: First page Last page Next page Previous page Page number (selected from spinner)
	Sort Rows	Sorts the target dataset according to the order specified in the field in the Action Properties section.
	Submit Form	Starts execution of the form.
	Custom Action	User-definable action.
Action code		Read-only field displaying the defined formula for the action.
Apply to	Self	Defines on which element to apply the action.
Apply to	[other UI component in iView]	Defines on which element to apply the action.
Validation scope	None	Defines the controls that will undergo validation once the action is triggered: None – No validation occurs. For example, a Cancel action requires no validation. Self – Validates only the control that invokes the action. Element – Validates all controls in the UI element (such as form or table) that contains the control that invokes the action. For example, if Apply to is set to Self, clicking a Submit button in a form triggers validation of all fields in the form to which validation conditions have been defined. Window – Validates all controls displayed in the window containing the control that invokes the action. For example, controls in components such as forms, but not nested iViews or popups, and in the selected layer, will be validated.
	Self
	Element
	Window
Action Properties		Action-specific parameters, described previously in this column per action.