### IFontDialogHandler

  The IFontDialogHandler class handles the various messages that affect the font dialog.

  Create a handler derived from IFontDialogHandler and attach it to a font dialog. You can do this by calling IHandler::handleEventsFor to pass the appropriate font dialog to the font dialog handler.
  Note: To add a handler to a modal font dialog, you must specify a pointer to the handler on the IFontDialog constructor.

  When the font dialog handler receives a font dialog event, it creates an IFontDialog object and routes that object to the IFontDialogHandler::modelessResults virtual function. Override this virtual function to supply your own specialized processing of a font dialog event.

  The return value from the virtual function specifies whether the font dialog event is passed on for additional processing, as follows:

  true
    The font dialog event requires no additional processing. Do not pass it to another handler.
  false
    Pass the font dialog event to the next handler for additional processing, as follows:
    - If there is another handler for the font dialog, pass the font dialog event to the next handler.
    - If this is the last handler for the font dialog, call IWindow::defaultProcedure to process the font dialog event.

### IFontDialogHandler - Member Functions and Data by Group

### Constructors & Destructor

You can construct and destruct objects of this class.

~IFontDialogHandler

      public:
      virtual ~IFontDialogHandler()

Supported Platforms

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

IFontDialogHandler

      public:
      IFontDialogHandler()

  You can only construct objects of this class using the default constructor, which does not accept any parameters.

Supported Platforms

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

### Dispatch Events

These members determine if the event is one of the font dialog events. If it is, it calls the appropriate function.

dispatchHandlerEvent

      protected:
      virtual bool dispatchHandlerEvent(IEvent& event)

  If a font dialog event is received, the appropriate virtual function is called.

Supported Platforms

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

### Font Dialog Events

These members are called when a file dialog event occurs. Override these to provide your own processing.

modelessApply

      protected:
      virtual bool
        modelessApply( IFontDialog* modelessDialog,
                       IFont* appliedFont )

  Called when the apply button of a modeless dialog is pressed. Allows you to update an application based on the current setting of the dialog without closing the dialog.

  appliedDialog
    Use the IFontDialog* pointer to get additional information about the dialog.
  appliedFont
    The font that is currently selected in the dialog. This is the IFont object that was passed into the dialog in a settings object and has been modified based on the current settings of the dialog.

Supported Platforms

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

modelessResults

      protected:
      virtual bool modelessResults(IFontDialog* endingDialog)

  Called when a modeless dialog is ended. This function is called even if the dialog is cancelled. This is done so that you can destroy the IFontDialog if needed. Use IFontDialog::pressedOK to determine whether the user ended the dialog by pressing the OK push button.

  If you need to destroy the IFontDialog object, do not delete the IFontDialog* pointer from within IFontDialog::modelessResults. Instead, call the following function:

         endingDialog->setAutoDeleteObject().

Supported Platforms

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

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

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  IHandler

  -     virtual IEventResult defaultProcedure(IEvent& event)

  -     virtual bool dispatchHandlerEvent(IEvent& event) = 0

#### Inherited Protected Data

  - None