Form control events

When a record script is triggered by a form control, Rational® ClearQuest® passes the record script an EventObject object as its parameter. This object contains information about the type of event that occurred. Different controls can generate different types of events, including button clicks, item selections, and so on. You must use the information in the EventObject object to determine how to handle the event.

Rational ClearQuest generates the following types of events for form controls:

The following table lists the supported type of event for each control and the extra information provided by the EventObject. The constants listed under the supported event type column are part of the EventType constants enumerated type.

Control type Supported event type Additional information
Push button _BUTTON_CLICK Null string
Combo box _CONTEXMENU_ITEM_SELECTION Null string
Drop-down list box _CONTEXMENU_ITEM_SELECTION Null string
List box _CONTEXMENU_ITEM_SELECTION Current® field value selection
List view _CONTEXMENU_ITEM_SELECTION Current field value selected
Text box _CONTEXMENU_ITEM_SELECTION Current field value selected
Drop-down combo box _CONTEXMENU_ITEM_SELECTION Null string