原生 XFA Draw 與 Caption 值

壓平與 AcroForm 消費端讀取已實體化的逐 instance scalar 值(draw 與 push button caption),包括 template 沒有值容器時建立的值

建立與變更內容

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 = "";

支援的 scalar 類別為 boolean、date、dateTime、decimal、float、integer、text 與 time;draw 內容保留 supplied 文字,不做數值強制轉換,也不套用新的 picture 格式

既有 template scalar 值可接受原生表單覆寫,缺席的值則在選定的原生表單 occurrence 中建立

重複的第一個 occurrence 保留原始內容;新增的重複 instance 取得獨立的 draw 與 caption 值,並在原生 XDP 重新載入後存活

明確空值

明確的空 draw 覆寫會抑制 template 文字,而不是恢復它

明確的空 caption 保持空白;沒有 scalar caption 內容的按鈕保留欄位名稱 fallback

儲存的空白 caption 可能省略原生 PDF caption 條目,其實際外觀不含任何標籤文字

持久化與 rollback

scalar 建立與內容寫入持久化實際的原生表單節點;已存 PDF 產生器在產生 PDF 之前重新載入原生 XDP

聚焦的驗收檢查初始建立、明確清空與新增重複 instance 的原生 XDP 葉節點、實際 PDF caption 與外觀運算子,以及可見 MuPDF 文字

script 失敗與原生內容預算失敗會逐位元組還原原生 XDP,包括在後續 draw 變更失敗之前已套用的 caption 變更

相關 API

原生 Scalar 值屬性、缺席屬性建立與互動式 XFA Runtime