Edit

IFontDisp interface (ocidl.h)

  • Article

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

See also

IFont