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.
You can construct and destruct objects of this class.
![]() |
public:
virtual ~IFrameWindowNotifyHandler()
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
IFrameWindowNotifyHandler()
Provides the default constructor.
Note:
Windows | OS/2 | AIX |
Yes | Yes | Yes |
Notification handlers process events that are sent or posted to a window by calling observer objects interested in those events.
![]() |
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.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
virtual ~IHandler()
virtual IString asDebugInfo() const
virtual IString asString() const
virtual IHandler& disable()
virtual IHandler& enable(bool enable = true)
virtual IHandler& handleEventsFor(IWindow* window)
IHandler()
bool isEnabled() const
virtual IHandler& stopHandlingEventsFor(IWindow* window)
virtual ~IWindowNotifyHandler()
IWindowNotifyHandler()
virtual IEventResult defaultProcedure(IEvent& event)
virtual bool dispatchHandlerEvent(IEvent& event) = 0