IFontDisp interface (ocidl.h)
Exposes a font object's properties through Automation. It provides a subset of the IFont methods.
Inheritance
The IFontDisp interface inherits from the IDispatch interface.
Remarks
The following table describes the dispIDs for the various font properties.
| Constant | 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. These properties support both read and write access.
| Property | Type | Access | 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. |
OLE Implementation
The system provides a standard implementation of a font object with the IFontDisp interface on top of the underlying system font support. A font object is created through the function OleCreateFontIndirect. A font object supports a number of read/write properties as well as a set of methods through its interface IFont and supports the same set of properties (but not the methods) through a dispatch interface IFontDisp which is derived from IDispatch to provide access to the font's properties through Automation. The system implementation of the font object supplies both interfaces.Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | ocidl.h |