HPDFXFABuildButtonAppearance

單元：HPDFXFAHeadless

function HPDFXFABuildButtonAppearance(const Text, Style: AnsiString;
  Width, Height: Double; const TrueTypeFont: SysUtils.TBytes;
  FirstObjectNumber: Integer; const Options: TXFAHeadlessPDFOptions;
  const ResolvedCaptionRuns: THPDFHeadlessRichTextRuns = nil): THPDFXFAButtonAppearance;

以與自動 headless XFA 建立相同的標題、狀態、字型與版面消費端，準備一份實際的 pushbutton 外觀；Text 為 UTF-8，Style 為 XFA 版面 callback 發射的中繼資料，Width/Height 為物理 PDF points

TrueTypeFont 提供真實的預設程式；Options.CaptionFontFamilies 供應額外的實際 regular、bold、italic 與 bold-italic 程式，連同其宣告的標籤

FirstObjectNumber 必須為正，並為所有產生的連續物件編號保留空間；回傳的套件擁有可達的原生物件，以及獨立的 widget 屬性與預設字型根

此工廠不會修改呼叫端文件或寫入呼叫端串流；準備期間適用字型、glyph、輸入、物件、序列化位元組與取消檢查

ResolvedCaptionRuns 為 nil 時保留既有的設定 family 路徑；選用的覆寫支援另行解析的安裝字型目錄，且不會取代原始文字或格式

非空覆寫要求目前的 rich 標題酬載，且 run 數量與文字、樣式、字級、顏色、底線、刪除線、段落邊界、對齊與有序 FontFamilyCandidates 必須完全一致；只有 FontFamily 可以改成設定標籤

共用字型後備接著會挑選在所有參與樣式間涵蓋完整 grapheme 的真實 family；缺少的 bold 或 italic 程式絕不合成

normal/down/rollover 標題中繼資料、明確空標題、隱藏標題與正常的零保留行為遵循 pushbutton 標題語義