IFontDisp 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 a COM-provided implementation of the font object.

When to use

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

Members

The IFontDisp interface inherits from the IDispatch interface but does not have additional members.

Remarks

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

ConstantValue
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.

PropertyTypeAccessDescription
NameBSTRRWThe facename of the font, e.g. Arial.
SizeCYRWThe point size of the font, expressed in a CY type to allow for fractional point sizes.
BoldBOOLRWIndicates whether the font is boldfaced.
ItalicBOOLRWIndicates whether the font is italicized.
UnderlineBOOLRWIndicates whether the font is underlined.
StrikethroughBOOLRWIndicates whether the font is strikethrough.
WeightshortRWThe boldness of the font.
CharsetshortRWThe 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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OCIdl.h

IDL

OCIdl.idl

IID

IID_IFontDisp is defined as BEF6E003-A874-101A-8BBA-00AA00300CAB

See also

IFont

 

 

Community Additions

ADD
Show:
© 2014 Microsoft