Spire.PDF 12.10.7、PDF フォームフィールドとXFAフォームのサポートを追加

Spire.PDF 12.10.7 のリリースをお知らせいたします。本バージョンでは、PDF フォームフィールドの作成、読み取り、変更、フラット化を行うための新しい名前空間を追加しました。また、XFAフォームへの対応を拡張し、XML、FDF、XFDF 形式によるフォームデータのインポートとエクスポートをサポートしました。これらの機能強化により、開発者はインタラクティブな PDF フォームをより柔軟かつ効率的に処理できるようになります。

1. Spire.Pdf.Interactive.Forms 名前空間を追加

新しい Spire.Pdf.Interactive.Forms 名前空間は、PDF フォームフィールドの作成、読み取り、変更、フラット化を行うための統一された包括的な API を提供します。 一般的な AcroForm フィールドタイプに対応しており、主なプロパティとメソッドは以下のとおりです。

対応する AcroForm フィールドタイプ

上記の各フィールド固有のメンバーに加え、すべてのフィールドは PdfField から以下の共通プロパティを継承します。

• IsReadOnly：フィールドが読み取り専用かどうかを指定します。
• IsRequired：フィールドが必須かどうかを指定します。
• AlternateName：フィールドの代替名を取得または設定します。
• MappingName：フィールドのマッピング名を取得または設定します。
• DefaultAppearance：フィールドのデフォルト外観を取得または設定します。

また、すべてのフィールドで Flatten() メソッドを呼び出し、フォームフィールドを静的なページコンテンツに変換できます。

2. XFA フォームへの対応を拡張

本バージョンでは、Spire.Pdf.Interactive.Forms.Xfa サブ名前空間を通じて、XFA フォームにアクセスする機能も追加しました。 XFA フォームのフィールド名やフィールドオブジェクトを取得し、フィールドの値を確認できるほか、さまざまな種類の XFA フィールドを処理できます。

対応する XFA フォームフィールドタイプ

すべての XFA フィールドは、XfaField から以下の共通プロパティを継承します。

• Name：フィールド名。
• XfaForm：フィールドが属するXFAフォーム。
• FieldType：フィールドタイプの識別子。

なお、XfaSignatureField（署名フィールド）と XfaPushButtonField（プッシュボタン）は、追加のパブリックプロパティを定義しておらず、主に継承した共通メンバーを通じてアクセスします。

3. フォームデータのインポートとエクスポートに対応

PdfForm を使用して、XML、FDF、XFDF 形式のフォームデータをインポートおよびエクスポートできるようになりました。 この機能により、PDF フォーム、業務システム、サードパーティ製 PDF ツール間でフォームデータを簡単に交換できます。
以下のコードは、フォームデータを XFDF ファイルにエクスポートし、そのファイルからデータを再度インポートする方法を示しています。

コード例

using System.Drawing;
  using System.Collections.Generic;
  using Spire.Pdf;
  using Spire.Pdf.Graphics;
  using Spire.Pdf.Interactive.Forms;

  PdfDocument doc = new PdfDocument();
  PdfPageBase page = doc.Pages.Add();

  // PdfForm.Create() を使用してフォームコンテナーを取得
  PdfForm form = PdfForm.Create(doc);

  // テキストフィールドを作成してページに追加
  PdfTextField nameField = new PdfTextField(form, "Address.Street");
  nameField.DefaultAppearance = new PdfDefaultAppearance(
      new PdfFont(PdfFontFamily.Helvetica, 12), new PdfRGBColor(0, 0, 0));
  nameField.AddWidget(page, new RectangleF(100, 100, 250, 30));
  nameField.Value = "123 Main St";

  // 名前とプレフィックスでフィールドを取得
  PdfField field = form.GetField("Address.Street");
  List<PdfField> addressFields = form.Fields.FindByPrefix("Address");

  // フォームをフラット化してドキュメントを保存
  form.Flatten();
  doc.SaveToFile("output.pdf");

  Form data can also be exchanged directly in formats such as XFDF:
  // フォームデータをXFDF形式でエクスポートし、ファイルから再度インポート
  form.ExportData("form.xfdf", DataFormat.XFDF, "PurchaseOrder");
  form.ImportData("form.xfdf", DataFormat.XFDF);