Skip to content

Latest commit

 

History

History
117 lines (81 loc) · 3.61 KB

nf-dwrite_3-idwritefontsetbuilder2-addfont.md

File metadata and controls

117 lines (81 loc) · 3.61 KB
UID title description helpviewer_keywords tech.root ms.date ms.keywords req.construct-type 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 f1_keywords dev_langs topic_type api_type api_location api_name
NF:dwrite_3.IDWriteFontSetBuilder2.AddFont
IDWriteFontSetBuilder2::AddFont
Adds a font to the set being built.
IDWriteFontSetBuilder2 interface [Direct Write]
AddFont method
IDWriteFontSetBuilder2.AddFont
IDWriteFontSetBuilder2::AddFont
AddFont
AddFont method [Direct Write]
AddFont method [Direct Write]
IDWriteFontSetBuilder2 interface
directwrite.idwritefontsetbuilder2_addfont
dwrite_3/IDWriteFontSetBuilder2::AddFont
DirectWrite
09/16/2019
IDWriteFontSetBuilder2 interface [Direct Write],AddFont method, IDWriteFontSetBuilder2.AddFont, IDWriteFontSetBuilder2::AddFont, AddFont, AddFont method [Direct Write], AddFont method [Direct Write],IDWriteFontSetBuilder2 interface, directwrite.idwritefontsetbuilder2_addfont, dwrite_3/IDWriteFontSetBuilder2::AddFont
function
dwrite_3.h
Windows
Windows 10 Build 20348
Windows 10 Build 20348
Dwrite.lib
Windows
IDWriteFontSetBuilder2::AddFont
dwrite_3/IDWriteFontSetBuilder2::AddFont
c++
APIRef
kbSyntax
COM
Dwrite.lib
Dwrite.dll
IDWriteFontSetBuilder2::AddFont

-description

Adds a font to the set being built, with the caller supplying enough information to search on and determine axis ranges, avoiding the need to open the potentially non-local font.

-parameters

-param fontFile

Type: IDWriteFontFile*

Font file reference object to add to the set.

-param fontFaceIndex

Type: UINT32

The zero-based index of a font face in a collection.

-param fontSimulations

Type: DWRITE_FONT_SIMULATIONS

Font face simulation flags for algorithmic emboldening and italicization.

-param fontAxisValues

Type: DWRITE_FONT_AXIS_VALUE const *

A pointer to an array containing a list of font axis values. The array should be the size (the number of elements) indicated by the fontAxisValueCount argument.

-param fontAxisValueCount

Type: UINT32

The number of font axis values contained in the fontAxisValues array.

-param fontAxisRanges

Type: DWRITE_FONT_AXIS_RANGE const *

List of axis ranges.

-param fontAxisRangeCount

Type: UINT32

Number of axis ranges.

-param properties

Type: DWRITE_FONT_PROPERTY const *

List of properties to associate with the reference.

-param propertyCount

Type: UINT32

The number of properties defined.

-returns

Type: HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

The font properties should include at least a family (typographic or weight/style/stretch). Otherwise the font would be accessible in the IDWriteFontSet only by index, not name.

-see-also