IFrameWindowNotifyHandler

The IFrameWindowNotifyHandler class processes events for all classes of frame windows.

This class is designed to handle events that require the frame window class to generate a notification. If notifications are enabled for the frame window, a notification will be generated and sent to all its observers when the proper conditions for the specific notification exist.

If you create a class derived from IFrameWindow that needs to notify observers of additional events, create a class derived from IFrameWindowNotifyHandler that overrides dispatchHandlerEvent. In the class derived from IFrameWindow, implement enableNotification to call IWindow::setNotificationHandler, passing it an object of the class derived from IFrameWindowNotifyHandler.


IFrameWindowNotifyHandler - Member Functions and Data by Group

Constructors & Destructor

You can construct and destruct objects of this class.


[view class]
~IFrameWindowNotifyHandler
public:
virtual ~IFrameWindowNotifyHandler()

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
IFrameWindowNotifyHandler
public:
IFrameWindowNotifyHandler()

Provides the default constructor.
Note: Generally, you do not need to construct an object of this class. Calling IFrameWindow::enableNotification causes an IFrameWindowNotifyHandler object to be constructed and added to the window, if necessary.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Event Dispatching

Notification handlers process events that are sent or posted to a window by calling observer objects interested in those events.


[view class]
dispatchHandlerEvent
protected:
virtual bool dispatchHandlerEvent(IEvent& event)

Notifies the frame window observers when it receives any of the following events:

This function also calls IWindowNotifyHandler::dispatchHandlerEvent so that observers will also be notified of generic window events.

If you create a class derived from IFrameWindowNotifyHandler, its dispatchHandlerEvent function should call IFrameWindowNotifyHandler::dispatchHandlerEvent for events it does not process.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


IFrameWindowNotifyHandler - Inherited Member Functions and Data

Inherited Public Functions

IHandler
IWindowNotifyHandler

Inherited Public Data

Inherited Protected Functions

IHandler

Inherited Protected Data