beginNotificationForIF

beginNotificationForIF(theObj:       Object;
                       eventType:    Integer;
                       responseType: Integer;
                       eventTag:     Integer;
                       theInterface: JadeInterface);

The beginNotificationForIF method of the Object class is a variation of the beginNotification method. The beginNotificationForIF method allows notification events to be sent to the userNotification and sysNotification methods mapped to the theInterface parameter when a nominated event occurs on instances of an object, rather than to those of the subscriber.

The subscriber must be an instance of a Class that includes methods that map to (implement) the specified sysNotification or userNotification method of the interface.

The parameters specified in the method signatures must match the standard userNotification or sysNotification method, as follows.

sysNotification(eventType: Integer; theObject: Object; eventTag: Integer);

userNotification(eventType: Integer; theObject: Object; eventTag: Integer;                  userInfo: Any);

If the method signature does not match the standard userNotification or sysNotification method, an exception is raised when the beginNotificationForIF method is executed.

The request for a notification registered by the beginNotificationForIF method is terminated by the endNotificationForIF method. You can also use the endNotificationForSubscriber method to terminate all previous notifications for a specified subscriber.

The beginNotificationForIF method parameters are summarized in the following table.

Parameter Specifies …
theObj The object for which the notification is to be invoked
eventType The type of event for which the notification is requested
responseType The frequency with which an event notification is sent
eventTag An integer value used to identify a notification subscription that will be passed back to the notification method
theInterface The interface implemented by the specified object

With the exception of the theInterface parameter, described in the following subsection, for details about the other parameters, see the appropriate subsections of the beginNotification method.