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 布局回调输出的元数据

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 字段