Actions and Events        

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:

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.

See Also

Example: Opening a Display

To connect an object to a control