THotPDF.ImportLoadedFormFromXFDF Method

XML Forms Data Format (XFDF) ファイルから、ロード済みドキュメントへフォームフィールド値を取り込みます

取り込みは全フィールドにわたって原子的です。後の方で値が拒否されると、それより前の値と生成済みの外観がロールバックされます。取り込みが成功した場合、呼び出し側が所有する外側のグラフトランザクションはそのまま保持されます

複数の value 要素は、改行でテキストを連結 / 分割することなくマルチセレクト choice フィールドを満たします。対応している選択は、祖先のデフォルトや兄弟フィールドを変更せずに、フィールド値と選択インデックスを再構築します

value を持たない field 要素は既存のフィールドをそのまま残します。空の value 1 つは、空のエクスポートオプションを持たないマルチセレクトフィールドをクリアし、そのオプションが存在する場合はそれを選択します

配列値は対象フィールドを変更する前に検証されます。表示テキストや choice の外観を変更する必要がある場合は、保存の前に外観の再生成を明示的に要求してください

正確なオプション値が、取り込まれた選択リスト全体でオプションの順序に関係なく優先されます。一致しない XFDF テキストだけが 16 進表記の互換フォールバックを使え、フォールバックが成功すると実際に一致したオプション値を保存します

低レベルの HPDFXFDFImportFields オーバーロードは、別途初期化された THPDFXFDFArrayAccess レコードを受け付けます。そのセッターは値リスト全体を処理した後に true を返し、そうでなければ単一の値がスカラーSetterへフォールバックし、複数の値は拒否されます

元の低レベルオーバーロードは、既存の統合のために複数値を LF で連結するレガシー挙動を保持します。THotPDF は新しい配列対応オーバーロードを使います

Syntax

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

Parameters

AFileName: TFileName

取り込む XFDF データのファイル名

Return Value

更新されたフィールドの数を返します。ファイルが見つからない場合は 0 を返し、ファイル I/O や拒否されたフィールド更新は例外を発生させることがあります