The IDLitIMessaging::AddOnNotifyObserver procedure method is used to register a specified iTool component object to receive messages generated by the DoOnNotify method of another specified iTool component object.
Obj->[IDLitIMessaging::]AddOnNotifyObserver, IdObserver, IdSubject
The object identifier of an iTool component object that is the observer expressing interest in the subject specified by IdSubject. Often, IdObserver is the object identifier of the object on which this method is being called.
The object specified by IdObserver must implement the OnNotify callback method, which is called when a notification message is dispatched to IdObserver by the DoOnNotify method of another iTool component object (usually the object specified by IdSubject). The OnNotify method has the following signature:
PRO ::OnNotify, idOriginator, idMessage, message
In general, the idMessage string is used by the OnNotify method to determine what type of action to take. See IDLitIMessaging::DoOnNotify for additional details.
A string value identifying the item that IdObserver is interested in. This is normally the object identifier of a particular iTool component object, but it can be any string value. When a message sent via IDLitIMessaging::DoOnNotify specifies IdSubject as the originator, the IdObserver object's OnNotify method is called.