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.


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

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
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.


[view class]
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.


[view class]
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


[view class]
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

Inherited Public Data

Inherited Protected Functions

IHandler

Inherited Protected Data