# IFontDisp

This interface exposes a font object’s properties through Automation. It provides a subset of the IFont methods.

##### When to Implement

A font object implements this interface along with IFont to provide access to the font’s properties through Automation. Typically, it is not necessary to implement this interface on your own object, since there is an OLE-provided implementation of the font object.

The following table describes the dispIDs for the various font properties.

Symbol | Value
DISPID_FONT_NAME | 0
DISPID_FONT_SIZE | 2
DISPID_FONT_BOLD | 3
DISPID_FONT_ITALIC | 4
DISPID_FONT_UNDER | 5
DISPID_FONT_STRIKE | 6
DISPID_FONT_WEIGHT | 7
DISPID_FONT_CHARSET | 8

Each property in the IFontDisp interface includes a get_PropertyName method if the property supports read access and a put_PropertyName method if the property supports write access. Most of the properties support both read and write access and thus expose both “get” and “put” methods for these properties.

Property | Type | Access Allowed | Description
Name | BSTR | RW | The facename of the font, e.g. Arial.
Size | CY | RW | The point size of the font, expressed in a CY type to allow for fractional point sizes.
Bold | BOOL | RW | Indicates whether the font is boldfaced.
Italic | BOOL | RW | Indicates whether the font is italicized.
Underline | BOOL | RW | Indicates whether the font is underlined.
Strikethrough | BOOL | RW | Indicates whether the font is strikethrough.
Weight | short | RW | The boldness of the font.
Charset | short | RW | The character set used in the font, such as ANSI_CHARSET, DEFAULT_CHARSET, or SYMBOL_CHARSET.

##### When to Use

Use this interface to change or retrieve the properties of a font object through the IDispatch::Invoke method in Automation.

Methods in Vtable Order

IUnknown Methods | Description
QueryInterface | Returns pointers to supported interfaces.
AddRef | Increments reference count.
Release | Decrements reference count.

See Also

IFont