beginNotifyAutomationEvent

beginNotifyAutomationEvent(receiver:          Object;
                           eventClassRefName: String);

The beginNotifyAutomationEvent method of the ActiveXAutomation class registers the receiver to be notified when a specified event occurs on an ActiveX automation object. The object that invokes the beginNotifyAutomationEvent is referred to as the subscriber.

An object that subscribes to an automation notification is notified when the nominated event occurs for that object.

The parameters for this method are listed in the following table.

Parameter Description
receiver The object that is to receive the event notification
eventClassRefName The name of the reference (an instance of the IDispatch subclass) that implements the notification events

A method implemented by the eventClassRefName parameter is executed each time its corresponding automation event occurs.

This event notification continues until the JADE automation object is deleted or until the endNotifyAutomationEvent method is called. The endNotifyAutomationEvent method has the same signature as the beginNotifyAutomationEvent method.

There may be an impact on performance, particularly in JADE thin client mode or on a slow communications link, if you register for large numbers of automation events or events that are triggered often; for example, a cell change event in the Excel automation type library. (For details about JADE thin client mode performance, see "JADE Thin Client Performance Considerations", in Appendix A of the JADE Thin Client Guide.)

For more details about automation events, see "Using Automation Events", in Chapter 4 of the JADE External Interface Developer’s Reference.