原生 XFA Draw 与 Caption 值

扁平化与 AcroForm 消费方读取已物化的按实例标量值(用于 draw 与 pushbutton caption),包括模板没有值容器时创建的值

创建与修改内容

const row = xfa.form.resolveNode("main.row[1]");
row.label.value.text.value = "Visible draw";
row.button.caption.value.text.value = "Visible caption";
row.label.value.text.value = "";

受支持的标量类别为 boolean、date、dateTime、decimal、float、integer、text 与 time;draw 内容保留 supplied 文本,不做数值强转或新 picture 格式化

既有模板标量值可接收原生表单覆写;缺失的值在选定的原生表单实例中创建

重复的首实例保留原内容;新增重复实例获得独立的 draw 与 caption 值,并在原生 XDP 重载后存续

显式空值

显式空 draw 覆写会抑制模板文本,而不是恢复它

显式空 caption 保持空白;没有标量 caption 内容的按钮保留字段名回退

保存的空白 caption 可以省略原生 PDF caption 条目,其真实外观不保留任何标签文本

持久化与回滚

标量创建与内容写入持久化真实原生表单节点;保存 PDF 的生产者在生成 PDF 之前重载原生 XDP

聚焦验收针对初始创建、显式清空与新增重复实例,检查原生 XDP 叶节点、真实 PDF caption 与外观算子以及可见 MuPDF 文本

脚本失败与原生内容预算失败都按字节精确还原原生 XDP,包括后继 draw 变更失败之前已应用的 caption 变更

相关 API

原生标量值属性, 缺失属性创建和 交互式 XFA 运行时