AddTrueTypeFontA

Text, Fonts

Description

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to AddTrueTypeFont and string arguments are interpreted using the current SetAnsiMode code page

Adds a TrueType font to the document. The font must be installed on the system. If the font is not embedded, then the reader of the PDF document must have the font installed on their system too. If the font is embedded, then the reader does not need the font installed on their system

Embedding a font makes the PDF file much larger. Some fonts are not licensed to be embedded

Syntax

Delphi

Function DLAddTrueTypeFontA(InstanceID: Integer; FontName: PAnsiChar; Embed: Integer): Integer;

DLL

int DLAddTrueTypeFontA(int InstanceID, const char * FontName, int Embed);

Parameters

FontName	The name of the TrueType font to install. This can either be the name of the font as shown in the Windows\Fonts folder (for example 'Times New Roman') or it can be the font family name with an optional style specifier in square brackets (for example 'Times New Roman [BoldItalic]'). Possible optional specifiers are: [Bold], [Italic] or [BoldItalic]. A codepage can also be specified (for example 'Arial [Bold] {1250}') which allows other encodings to be used. Possible code pages are: {0} Direct mapping {437} OEM_CHARSET {850} OEM_CHARSET {852} OEM_CHARSET {874} THAI_CHARSET {1250} EASTEUROPE_CHARSET {1251} RUSSIAN_CHARSET {1252} ANSI_CHARSET {1253} GREEK_CHARSET {1254} TURKISH_CHARSET {1255} HEBREW_CHARSET {1256} ARABIC_CHARSET {1257} BALTIC_CHARSET {1258} VIETNAMESE_CHARSET {1361} JOHAB_CHARSET Specifies whether to embed the font or not: 0 = Don't embed the font 1 = Embed the font
Embed

FontName

The name of the TrueType font to install. This can either be the name of the font as shown in the Windows\Fonts folder (for example 'Times New Roman') or it can be the font family name with an optional style specifier in square brackets (for example 'Times New Roman [BoldItalic]'). Possible optional specifiers are: [Bold], [Italic] or [BoldItalic]. A codepage can also be specified (for example 'Arial [Bold] {1250}') which allows other encodings to be used. Possible code pages are: {0} Direct mapping {437} OEM_CHARSET {850} OEM_CHARSET {852} OEM_CHARSET {874} THAI_CHARSET {1250} EASTEUROPE_CHARSET {1251} RUSSIAN_CHARSET {1252} ANSI_CHARSET {1253} GREEK_CHARSET {1254} TURKISH_CHARSET {1255} HEBREW_CHARSET {1256} ARABIC_CHARSET {1257} BALTIC_CHARSET {1258} VIETNAMESE_CHARSET {1361} JOHAB_CHARSET Specifies whether to embed the font or not: 0 = Don't embed the font 1 = Embed the font

Embed

Return values

0	The font could not be added. This may mean that the font is not licensed to be embedded, or that the font could not be found
Non-zero	The ID of the font that was successfully added. This ID can be used with the SelectFont function to select the font