THotPDF.ImportLoadedFormFromXFDF 方法

從 XML Forms Data Format (XFDF) 檔案中將表單欄位值匯入至已載入的檔案中

匯入對所有欄位是原子的：後面的更新被拒就會回復先前的值與產生的外觀，而匯入成功時會保留呼叫端外圍的圖形交易

多個 value 元素會填入多選 choice 欄位,不會依換行合併或拆開文字;受支援的選取項目會重建欄位值與選取索引,不修改上層預設值或同層欄位

沒有 value 的 field 元素會讓既有欄位保持不變;單一空值會清空沒有空匯出選項的多選欄位,若該選項存在則改為選取它

陣列值在改動目標欄位前會先驗證;當可見文字或選項外觀需要變化時,請在儲存前明確要求重新產生外觀

確切的選項值在整份匯入選取清單中優先,不受選項順序影響;只有未比對到的 XFDF 文字才能使用十六進位拼寫的相容性後備,後備成功時會儲存實際比對到的選項值

低階的 HPDFXFDFImportFields overload 接受獨立且已初始化的 THPDFXFDFArrayAccess 記錄;其 setter 處理完整值清單後回傳 true,否則單一值退回純量 setter,多個值則被拒絕

原始的低階 overload 為既有整合保留舊式行為,包括以 LF 連接多個值;THotPDF 則使用新的陣列感知 overload

語法

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

參數

AFileName: TFileName

要匯入的 XFDF 資料之檔案名稱

傳回值

傳回更新的欄位數;檔案不存在時傳回零,檔案 I/O 與被拒絕的欄位更新則可能擲出例外