HPDFXFABuildChoiceFieldAppearance

單元：HPDFXFAHeadless

function HPDFXFABuildChoiceFieldAppearance(const Kind, Value, Style: AnsiString;
  const Items: TXFAFieldOptions; Width, Height: Double;
  const TrueTypeFont: SysUtils.TBytes; FirstObjectNumber: Integer;
  const Options: TXFAHeadlessPDFOptions;
  GenerateAppearance: Boolean = True): THPDFXFAChoiceAppearance;

準備一個原生的 combo 或 list choice 欄位，不更動呼叫端文件或輸出串流，使用與自動 headless XFA 建立相同的選項、選取、捲動與外觀消費端

Kind 為 combo 或 list；Value 與 Items 包含 UTF-8 文字，Width 與 Height 是實體 PDF point，Style 包含 XFA 版面 callback 輸出的詮釋資料

Style 中精確的匯出與顯示陣列以及 raw 選取資訊優先於相容性的 Items 與 Value 參數，從而保留撰寫的空白與獨立的顯示標籤

回傳的封包包含 V、Opt、選取時的 I、list 的 TI、Ff 與 Q，請求時還有 AP 與 DA；不含欄位身分、頁身分、父節點與矩形

多選 list 儲存真實的 PDF 值陣列與按選項順序排列的選取索引；可編輯 combo 保留自由文字，不虛構選項索引

TrueTypeFont 為產生外觀提供真實字型程式；list 以真實字型度量捲動到選中選項可見，並以其顯示標籤繪製選中列

GenerateAppearance 預設 True；False 只準備詮釋資料，不需要字型程式，不建立 AP 或 DA，也不做任何字形工作；僅詮釋資料的 list 從第一個選取索引開始，因為最終視埠由閱讀器度量決定

FirstObjectNumber 必須為正，並為所有連續產生的物件編號留出空間；呼叫端保留該編號範圍、接納物件，並在把 Properties 掛到真實 widget 之前把 Fonts 註冊進自己的 AcroForm DR

在物件被接走之前，封包擁有全部物件；Options 中輸入、物件、字型、字形、序列化位元組與取消限制在準備全程生效

Windows THotPDF 消費端見legacy XFA choice 欄位