### 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.

~IFrameWindowNotifyHandler

      public:
      virtual ~IFrameWindowNotifyHandler()

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

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.

dispatchHandlerEvent

      protected:
      virtual bool dispatchHandlerEvent(IEvent& event)

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

  - Activate event
  - Deactivate event

  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

  -     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)

  IWindowNotifyHandler

  -     virtual ~IWindowNotifyHandler()

  -     IWindowNotifyHandler()

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  IHandler

  -     virtual IEventResult defaultProcedure(IEvent& event)

  -     virtual bool dispatchHandlerEvent(IEvent& event) = 0

#### Inherited Protected Data

  - None