IFontDisp 12XJDJ4

This interface exposes a font object s properties through Automation. It provides a subset of the IFont149OGQN 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
QueryInterface2Y54585	Returns pointers to supported interfaces.
AddRef1SHW0SS	Increments reference count.
ReleaseDUW01A	Decrements reference count.

See Also

IFont