XFA choice Callback 元数据

单元:HPDFXFA;Callback:TXFAEmitField

既有 Callback 签名与 Options 数组保留原有契约;这些增量 key 通过分号分隔的 Style 字符串传递给 combo、list、checkbox 与 radio 消费方

十六进制值用大写十六进制数字编码精确 UTF-8 字节,因此含分号、逗号、等号或 Unicode 的标签与导出不会破坏紧凑样式语法

键含义
choiceexportshex计数加冒号,后跟逗号分隔的生效保存列表十六进制值;显式空值保留一个条目
choicelabelshex同一计数格式的生效显示列表;原生创建器要求计数与导出列表一致
choicerawhex修剪后与产出的 choice 值一致时的精确原生 raw 值
choiceselectedhex可选的精确选中索引,以规范升序逗号分隔整数列表的十六进制 UTF-8 字节表示;空值显式表示不选择任何项,且 raw 值必须与选中的导出一致
buttonexporthex作为 checkbox 或 radio 成员 on 导出的首个生效标量项
buttonvaluehex修剪后与产出值一致时的精确 checkbox raw 值
radiovaluehex当前原生数据集作用域中排他组实际解析出的值
radiogrouphex十六进制编码的模板组路径与原生数据集上下文路径,用于独立于显示名称给成员分组
radioreadonly文档编辑或排他组访问限制原生 radio 父节点时为 1
choiceeditcombo 允许自由文本时为 1
choicemultilist 允许多个选中导出时为 1
choicecommit选择会提交 choice 值时为 1

计数列表 2:4142, 编码两个导出 AB 与空字符串;0: 编码空列表

生效的表单实例项覆盖模板项;显示列表缺失时回退到生效导出列表

Choice 条目脚本化把重复导出与空导出的显式索引持久化到可选的原生表单属性中;后续的字段、Data DOM 或条目导出值写入会使其状态失效

radio 作用域路径使用锚定在各自包上的真实原生子节点位置;相同文档结构下普通 XML 保存/重载会保留它们,结构性编辑可能产生新路径

Boolean 元数据为 checkbox 与 radio Callback 增加生效 marker、outline、标量 caption 与中性状态提示

自动原生 choice 创建描述 PDF 映射与验收夹具

自动列表滚动消费生效字号与控件高度来创建初始可见选项窗口,保留窗口外的全部导出/显示对与选中索引