PDPushButton

PDPushButtonは、Apache PDFBoxライブラリのPDModel API内の高レベルJavaクラスで、PDF文書内のプッシュボタンフォームフィールドを表します。プッシュボタンは、PDF仕様 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されたインタラクティブフォーム要素であり、クリックされるとフォームデータの送信、フィールドのリセット、JavaScriptの実行などのアクションをトリガーします。このクラスは、開発者がPDFフォーム内でプッシュボタンのプロパティをプログラムで作成、読み取り、変更するためのメソッドを提供します。

PDPushButtonは、Apache PDFBox内の具象実装クラスで、インタラクティブフォームフィールド階層を拡張し、プッシュボタンウィジェットを専門的に処理します。ユーザー入力を収集または保存するテキストフィールドやチェックボックスとは異なり、プッシュボタンはアクション指向のコントロールで、アクティブ化されるとコマンドを実行します。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているPDFフォームのコンテキストでは、プッシュボタンはボタンフィールドタイプ（フィールドタイプ「Btn」）に属しますが、ラジオボタンやチェックボックスとは異なり、永続的な値の状態を保持しません。プッシュボタンは、アクションをトリガーするためだけに存在します。PDPushButtonクラスは、プッシュボタンフィールドの低レベルディクショナリ構造をカプセル化し、PDF構文を直接処理することなく、ボタンの外観、アクション、動作プロパティを操作するための開発者フレンドリーなインターフェースを提供します。

インタラクティブPDFフォームを扱う開発者にとって、PDPushButtonはユーザーフレンドリーなフォームインターフェースを作成するために不可欠な機能を提供します。プッシュボタンは、フォーム送信ワークフロー、複数ステップのフォームナビゲーション、データ検証トリガー、動的フォーム動作を実装するために重要です。 ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) などの標準に準拠したアクセシブルなPDFフォームを開発する場合、適切なツールチップとラベルを持つ適切に構成されたプッシュボタンは、支援技術を使用するユーザーがフォームアクションと効果的に対話できることを保証します。PDPushButtonを理解することで、開発者はカスタムビジネスロジックを持つフォームをプログラムで生成し、一括文書処理シナリオでフォームフィールドの作成を自動化し、破損または欠落したボタン構成を持つ可能性のある既存のPDFフォームを保守または修復できます。

PDPushButtonは、PDFBoxオブジェクトモデル内で、ボタンフィールドを表す基礎となるPDFディクショナリ構造をラップすることによって動作します。開発者は、PDF文書内のすべてのインタラクティブフォームフィールドを管理するPDAcroFormインターフェースを通じて、PDPushButtonオブジェクトをインスタンス化または取得します。このクラスは、ボタンのキャプション、境界線スタイル、背景色などの視覚的プロパティを設定するメソッド、およびボタンが押されたときに何が起こるかを定義するアクションディクショナリをアタッチするメソッドを提供します。一般的なアクションには、submit-formアクション（データをURLに送信）、reset-formアクション（フィールド値をクリア）、JavaScriptアクション（カスタムスクリプトを実行）が含まれます。PDFが準拠ビューアーでレンダリングされると、プッシュボタンはクリック可能な要素として表示され、ユーザーのインタラクション時に関連するアクションが実行されます。PDPushButtonクラスは、これらの構成を ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義された適切なPDF構文にシリアル化することを処理し、異なるPDFリーダー間での互換性を保証します。 ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) ガイドラインに従ったアクセシブルなフォームの場合、開発者はスクリーンリーダーをサポートするために、PDPushButtonのアノテーションプロパティを通じて適切な代替説明とツールチップを設定する必要があります。

• PDAcroForm – プッシュボタンを含むすべてのフォームフィールドを管理するインタラクティブフォームディクショナリを表すコンテナクラス
• PDAnnotationWidget – PDFページ上でプッシュボタンがどのようにレンダリングされるかを定義する、フォームフィールドの視覚的外観コンポーネント
• PDAction – プッシュボタンにアタッチできる実行可能なアクションを表すクラス階層
• PDField – PDPushButtonが共通のフィールドプロパティを継承する、フォームフィールド階層の親クラス
• PDAppearanceStream – ボタンの状態のカスタム視覚表現を定義するグラフィカルコンテンツストリーム