WinDDA events
The Windows data-driven adapter (DDA) distinguishes between two types of events—application events and control events. This topic describes these two events.
Control events
Control events are fired by controls in an application. For all of these events, the control name must be specified during registration (RegisterActionForEvent
). The controls must also be accessible in the application during registration. You can use the FindControl method or add an exception handler to ensure that the control is accessible.
The Hosted Application Toolkit (HAT) Software Factory lists the events that are supported for a specific User Interface (UI) control type. If you do not specify the type in the UII Inspector, UII lists all events for the control. All available control events are listed by the Hosted Application Toolkit (HAT) Software Factory if no control type is detected. The following table describes the supported control events.
Element | Description |
---|---|
GotFocus | The event is raised when the control gets the focus. |
LostFocus | The event is raised when the control loses the focus. |
ButtonPressed | The event is raised when the button is clicked. |
ButtonReleased | The event is raised when the button is released. |
CheckBoxSet | The event is raised when the check box is selected. |
CheckBoxCleared | The event is raised when the check box is cleared. |
RadioButtonSet | The event is raised when the radio button is selected. |
The following table lists the events that each control supports.
Element | Description |
---|---|
Push Button | ButtonPressed, ButtonReleased, GotFocus, LostFocus |
Check Box | GotFocus, CheckBoxSet, CheckBoxCleared, LostFocus |
Radio Button | GotFocus, RadioButtonSet, LostFocus |
Text | GotFocus, LostFocus |
Editable Text | GotFocus, LostFocus |
Application events
Application events are not bound to a control; therefore, you do not have to specify a control name in the RegisterActionForEvent
activity. The following table describes the application events that are available in the Hosted Application Toolkit (HAT):
Element | Description |
---|---|
WindowShown | The event is raised when the window is displayed. |
WindowDisappeared | The event is raised when the window is hidden. |