Using Commands | To configure actions and commands
Commands are tasks you want to perform when an event (trigger) occurs. Use actions to navigate to different displays or web pages, print displays, write out data, toggle values, and so forth.
You can configure a display to execute specific tasks based on an action or an event. The action you select acts like a trigger. When the user performs the selected action it triggers the associated tasks to execute. For example, suppose you assign the mouseClicked action to a rectangle. When the user clicks the rectangle with the mouse, the task assigned to the action executes.
In addition to executing a task, you can also pass a parameter using the Link Control To feature. For example, suppose you assign mouseClicked to a Button. When the user clicks the Button, it passes a value to the configured parameter, which updates the grid or chart using the SQL statement.
The Link Control to feature is supported by the following objects:
Image (used as a source)
Button (used as a source)
A control linkage targets any valid connection on the display. When a control link is set up, the connection fires whenever the control input is triggered.
The following table lists the actions (events) you can configure for all objects:
The action... |
Triggers when... |
mouseClicked |
The user clicks an object with the mouse. |
actionPerformed |
The user performs an action on the object. For example, a selection is made from a combo box. |
valueChanged |
A value has changed. For example, a value is updated in a list box. |
enterKeyPressed |
The user presses the enter key. |
chartTimeChanged |
The user updates the time on a Time chart. |
timeDateChanged |
The user updates the time/date on a Time Component object. |
gridCellSelectionChanged |
The user selects a cell on a grid. |
gridColumnSelectionChanged |
The user selects a column on a grid. |
gridRowSelectionChanged |
The user selects a row on a grid. |
gridDataChanged |
The data on a grid has changed. |
gridTimeChanged |
The time on a grid has been updated. |