THotPDF.ExportLoadedFormToXFDF Method

名前付きのロード済みフォームフィールド（AcroForm）を、XML Forms Data Format (XFDF) ファイルへエクスポートします

スカラーのフィールド値は、空の値、前後の空白、タブ、改行を含めて正確なテキストを保持します。XML の整形は value 要素の外側に保たれます

エクスポートは実効的な継承値を使い、既存の AnsiString 表現を保持します。マルチセレクト配列は、改行を含む項目も含めて、選択された項目ごとに個別の value 要素を生成します

空の値配列は、オプションリストに空のエクスポート値が含まれない場合、明示的な空 value 要素としてエクスポートされます。空のエクスポート値が有効なオプションでもある場合、エクスポートはこの曖昧な空配列を出力ファイルの作成前に拒否します。明示的に保持したい場合は FDF を使えます

カスタムの低レベル統合では、別途初期化した THPDFXFDFArrayAccess レコードとともに HPDFXFDFExportFields オーバーロードを使えます。そのゲッターは配列値に対してのみ true を返し THPDFXFDFValueArray を供給します。元のアクセスレコードとオーバーロードは、既存のレイアウトとスカラー挙動を保ちます

Syntax

function ExportLoadedFormToXFDF(const AFileName: TFileName): Integer;

Parameters

AFileName: TFileName

XFDF データの保存先となる出力ファイル名

Return Value

エクスポートされた名前付きフィールドの数を返します。value 要素を持たない署名フィールドも含みます。数が 0 の場合、出力ファイルには触れず、ファイル I/O の失敗は例外を発生させます