THPDFHeadlessDocument.ImportFormDataToFile
function ImportFormDataToFile(const FileName: string;
const Bytes: SysUtils.TBytes; Format: THPDFHeadlessFormDataFormat;
const TrueTypeFont: SysUtils.TBytes;
const AppearanceOptions: THPDFHeadlessTextAppearanceOptions;
const Options: THPDFHeadlessFormDataOptions): Integer;
解碼所有提供的表單資料位元組,把實際變更值與重建的 widget 外觀套到私有修訂圖,並原子發布獨立的增量 PDF
回傳值計數變更的終端欄位,radio 群組算一個欄位;未變更的值保持原樣、不計為變更
已載入文件保留所有原始與先前準備的值、字型與外觀;輸出會先併入那些準備好的變更,再套用匯入值
只有名稱的條目不動欄位,簽名也不例外;為未知欄位或不支援的簽名/pushbutton 欄位提供值,會丟出 typed 診斷
文字欄位需要一個文字值,選擇欄位接受 scalar 文字或陣列,按鈕需要 scalar 匯出狀態;既有 checkbox 與 radio 匯出狀態保留
TrueTypeFont 必須包含所有需要的文字與按鈕 glyph;AppearanceOptions 透過既有原生外觀 setter 控制實際版面、shaping、間距與 widget 外觀
此進入點只提供 regular rich 字型槽;要為匯入的 rich 值提供真正的 bold、italic 與 bold-italic 程式,請用 ImportRichFormDataToFile
唯讀旗標、必要欄位約束、已驗證的 DocMDP 與 FieldMDP、先前簽章完整性與 AES 表單填寫權限,都在發布前強制執行
未變更的唯讀值允許冪等的往返;變更的唯讀或鎖定值會捨棄整個候選操作
來源檔不可以是目的地,實體別名也算;輸出路徑必須非空且不含 NUL
完整解碼模型在暫存之前驗證;其後任何失敗、取消或預算耗盡都會保留既有目的地,並移除未發布的私有檔案
私有加密圖在借用其修訂金鑰之前,必須保留精確的已驗證來源加密 dictionary;密碼不會被保留或重放
token 非 nil 時必須與已載入文件相符;表單資料與文件限制約束解析、欄位數、巢狀、文字、產生外觀與完整 PDF 輸出