Skip to content

Latest commit

 

History

History
181 lines (168 loc) · 4.13 KB

nn-ocidl-ifontdisp.md

File metadata and controls

181 lines (168 loc) · 4.13 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NN:ocidl.IFontDisp
IFontDisp (ocidl.h)
Exposes a font object's properties through Automation. It provides a subset of the IFont methods.
IFontDisp
IFontDisp interface [COM]
IFontDisp interface [COM]
described
_ctrl_ifontdisp
com.ifontdisp
ocidl/IFontDisp
com\ifontdisp.htm
com
c2ee251e-2419-4436-96e4-caaf6acc2550
12/05/2018
IFontDisp, IFontDisp interface [COM], IFontDisp interface [COM],described, _ctrl_ifontdisp, com.ifontdisp, ocidl/IFontDisp
ocidl.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
OCIdl.idl
Windows
19H1
IFontDisp
ocidl/IFontDisp
c++
APIRef
kbSyntax
COM
OCIdl.h
IFontDisp

IFontDisp interface

-description

Exposes a font object's properties through Automation. It provides a subset of the IFont methods.

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

-see-also

IFont