API referenceFonts

pdfNoEmbedFontListAdd

Nominally: blacklist a font name from being embedded.

CategoryFont policy (dead subsystem)
Exported namespdfNoEmbedFontListAddA, pdfNoEmbedFontListAddW, pdfNoEmbedFontListAdd
NoteThe list is stored but never consulted by embedding logic — see the chapter note

Purpose — Nominally: blacklist a font name from being embedded.

Description — Genuinely appends FontName to a case-insensitive TStringList (NoEmbedFonts), returning its 1-based position. The list itself behaves correctly for every list-management call in this family — the defect is that nothing reads this list when deciding whether to embed a font.

Declarations

C
int32_t __stdcall pdfNoEmbedFontListAdd(PPDF IPDF, const char* FontName);
int32_t __stdcall pdfNoEmbedFontListAddA(PPDF IPDF, const char* FontName);
int32_t __stdcall pdfNoEmbedFontListAddW(PPDF IPDF, const wchar_t* FontName);
Delphi
function pdfNoEmbedFontListAddA(const IPDF: PPDF; FontName: PAnsiChar): Integer; stdcall; external 'LumasPdf.dll';
function pdfNoEmbedFontListAddW(const IPDF: PPDF; FontName: PWideChar): Integer; stdcall; external 'LumasPdf.dll';

Parameters

ParameterTypeDescription
IPDFPPDFInstance handle.
FontNamestringFont name to add.

Return value — 1-based position in the list (i.e. the new count) on success; 0 on an invalid handle.

See alsopdfNoEmbedFontListCount

C# (P/Invoke)

wrappers/dotnet/LumasPdf.cs
public static extern int pdfNoEmbedFontListAddW(IntPtr IPDF, IntPtr FontName);
public static extern int pdfNoEmbedFontListAdd(IntPtr IPDF, IntPtr FontName);
public static extern int pdfNoEmbedFontListAddA(IntPtr IPDF, IntPtr FontName);
Area
Fonts
Category

Core

Exported names

pdfNoEmbedFontListAddW pdfNoEmbedFontListAdd pdfNoEmbedFontListAddA

String variants

The …A form takes UTF-8, …W takes UTF-16; a bare name aliases the ANSI form.

See working code

Worked examples — complete programs in ten languages.