IDWriteFontFallbackBuilder::AddMappings method (dwrite_2.h)

Adds all the mappings from an existing font fallback object, which can be used to compose larger fallback definitions. A common scenario is to start with the system fallback from IDWriteFactory2::GetSystemFontFallback to cover the majority of Unicode characters, but then customize a few ranges with additional application-specific entries, either appending them first (to have priority over the system default) before calling AddMappings; or calling AddMappings first, and then appending custom ranges to fill in any custom gaps.

Syntax

HRESULT AddMappings(
  IDWriteFontFallback *fontFallback
);

Parameters

fontFallback

Type: IDWriteFontFallback*

An existing font fallback object.

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