beginNotfiyAutomationEvent

beginNotifyAutomationEvent(receiver:          Object;
                           eventClassRefName: String);

The beginNotifyAutomationEvent method of the ActiveXControl class registers the receiver to be notified when a specified event occurs on an ActiveX control object when it has been created as an automation object. (For details, see the makeAutomationObject method.)

The control 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 ActiveXControl 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.