TXFAHeadlessPDFOptions.CaptionFontFamilies

單元：HPDFXFAHeadless

CaptionFontFamilies: THPDFHeadlessRichTextFontFamilies;

為自動的 checkbox、radio 與 push button caption 提供實際 TrueType 程式，涵蓋 rich XHTML runs 與 scalar caption 的字型 weight、posture 與 typeface

Default 回傳空陣列；既有的 TrueTypeFont 參數提供預設 regular 字面，要求的 bold、italic 與 bold-italic 字面則各自需要真實程式

明確提供的陣列含一到十六個家族，名稱相異、非空，且被原生 rich-text 解碼器接受；第一個家族是預設，第一個 regular 程式缺失時改用 TrueTypeFont

caption 的 font.typeface 以名稱選擇設定的家族，未設定時退回第一個家族；XHTML CSS font-family 清單採用解碼器既有的設定家族選擇

每個選用樣式使用對應的 hrfsRegular、hrfsBold、hrfsItalic 或 hrfsBoldItalic 位元組陣列；建立器不合成字面，也不從作業系統或網路載入字型

這些家族適用於 Boolean 與 push button caption；其他產生的欄位保留原本的 TrueTypeFont 契約

procedure ConfigureCaptionFaces(var Options: TXFAHeadlessPDFOptions;
  const RegularBytes, BoldBytes, ItalicBytes, BoldItalicBytes: TBytes);
begin
  SetLength(Options.CaptionFontFamilies, 1);
  Options.CaptionFontFamilies[0].FamilyName := 'Primary';
  Options.CaptionFontFamilies[0].Fonts[hrfsRegular] := RegularBytes;
  Options.CaptionFontFamilies[0].Fonts[hrfsBold] := BoldBytes;
  Options.CaptionFontFamilies[0].Fonts[hrfsItalic] := ItalicBytes;
  Options.CaptionFontFamilies[0].Fonts[hrfsBoldItalic] := BoldItalicBytes;
end;

先以 Default 初始化 Options 並備妥程式位元組，再呼叫建立器；同步呼叫期間不得變動那些陣列

MaxFontBytes 限制原本預設程式與每個 caption 用到的相異樣式程式總量；MaxBytes 另外限制候選 PDF 中所有內嵌程式

樣式程式在同一 caption 的片段之間共用；Boolean 狀態共用其共同的 caption Form，分別撰寫的 push button 狀態則保留各自的 caption 字型圖

缺字面、缺 glyph、無效字型程式、資源預算失敗與取消，會中止候選準備且不變動呼叫端的目的地 stream

選項與預算 · Rich caption 消費端行為 · Push button caption 與狀態