IDLitUI::AddOnNotifyObserver

Syntax | Arguments | Keywords | Version History

The IDLitUI::AddOnNotifyObserver procedure method is used to register a specified iTool component object as wishing to receive messages generated by the DoOnNotify method of another specified iTool component object.

Syntax

Obj->[IDLitUI::]AddOnNotifyObserver, IdObserver, IdSubject

Arguments

IdObserver

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, idObject, idMessage, message

where

idObject is the object identifier of the iTool component that is the source of the message.

idMessage is a string that identifies the type of message being sent.

message is the message data itself.

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.

IdSubject

A string 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.

Keywords

None

Version History


6.0	Introduced