IDWriteFontFallbackBuilder::AddMapping method (dwrite_2.h)

Appends a single mapping to the list. Call this once for each additional mapping.

Syntax

HRESULT AddMapping(
                 DWRITE_UNICODE_RANGE const *ranges,
                 UINT32                     rangesCount,
  [in]           WCHAR const                **targetFamilyNames,
                 UINT32                     targetFamilyNamesCount,
  [in, optional] IDWriteFontCollection      *fontCollection,
  [in, optional] WCHAR const                *localeName,
  [in, optional] WCHAR const                *baseFamilyName,
                 FLOAT                      scale
);

Parameters

ranges

Type: DWRITE_UNICODE_RANGE*

Unicode ranges that apply to this mapping.

rangesCount

Type: UINT32

Number of Unicode ranges.

[in] targetFamilyNames

Type: const WCHAR**

List of target family name strings.

targetFamilyNamesCount

Type: UINT32

Number of target family names.

[in, optional] fontCollection

Type: IDWriteFontCollection

Optional explicit font collection for this mapping.

[in, optional] localeName

Type: const WCHAR*

Locale of the context.

[in, optional] baseFamilyName

Type: const WCHAR*

Base family name to match against, if applicable.

scale

Type: FLOAT

Scale factor to multiply the result target font by.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement	Value
Minimum supported client	Windows 8.1 [desktop apps | UWP apps]
Minimum supported server	Windows Server 2012 R2 [desktop apps | UWP apps]
Target Platform	Windows
Header	dwrite_2.h
Library	Dwrite.lib
DLL	Dwrite.dll

See also

IDWriteFontFallbackBuilder