AddFontFallback

Text, fonts

Description

Adds an installed font face to the custom fallback chain

Syntax

Delphi

Function TPDFlib.AddFontFallback(Const FontName: WideString): Integer;

ActiveX

Function PDFlib::AddFontFallback(FontName As String) As Long

DLL

int DLAddFontFallback(int InstanceID, const wchar_t* FontName);

Parameters

FontNameInstalled face name checked before the built-in fallback candidates

Return values

Returns the one-based chain position, including the existing position for a duplicate, or 0 for an empty name

Remarks

The face is opened and cached lazily only when a primary font lacks a cluster, and adjacent clusters assigned to the same face are shaped together

The chain is retained by the library instance and is shared by its documents

See also

AddFontFallbackA, RemoveFontFallback, GetFontFallbackName