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:
- Button-click - Indicates that the user clicked a push button control.
- Pop-up menu item-selection - Indicates that the user invoked the hook from a pop-up menu.
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 |