PDActionRemoteGoTo

PDActionRemoteGoToは、Apache PDFBox PDModel APIにおけるクラスで、PDF文書内のリモートgo-toアクションを表します。このアクションタイプは、 ( 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文書内の特定の宛先へナビゲートすることを可能にします。このクラスは、リモート文書ナビゲーションアクションをプログラム的に読み取りおよび変更するためのメソッドを提供し、開発者がPDF処理アプリケーションにおいて文書間リンク機能を作成できるようにします。

PDActionRemoteGoToは、Apache PDFBoxのPDModel API内の高レベルJavaクラスで、 ( 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 ) で規定されているリモートgo-toアクションタイプをカプセル化します。同一PDF文書内のナビゲーションを扱うPDActionGoToとは異なり、PDActionRemoteGoToは外部PDFファイル内の宛先へユーザーを誘導するアクションを管理します。このクラスはPDActionクラス階層を継承し、リモートナビゲーションに必要なアクション辞書エントリ、すなわち対象文書を識別するファイル仕様（Fキー）と、その文書内のどこにビューアーがナビゲートすべきかを指定するオプションの宛先情報を具体的に処理します。このクラスは、基盤となるPDF辞書構造を抽象化し、リモートファイル参照、宛先ページ番号、対象文書を新しいウィンドウで開くかどうかといったプロパティに対して、Java開発者に使いやすいgetterおよびsetterメソッドを提供します。

文書管理システム、コンテンツポータル、または分散PDFコンテンツを扱うアプリケーションを構築する開発者にとって、PDActionRemoteGoToは洗練された文書間ナビゲーション体験の作成を可能にします。この機能は、相互に参照し合う必要がある複数の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 ) を作成する際に特に重要です。このクラスを理解することで、開発者は文書間リンクをプログラム的に作成、検査、変更できるようになり、これは自動PDF生成ワークフロー、文書組み立てシステム、および文書間参照を検証または修復する必要があるアクセシビリティ修正ツールにとって不可欠です。

PDActionRemoteGoToは、 ( 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 ) で定義されているSubtypeが「GoToR」（Go-To Remote）のPDFアクション辞書を表現することで機能します。このクラスをインスタンス化または操作する際、開発者は内部的に基盤となるCOS（Carousel Object Structure）辞書から読み取る、または書き込むメソッドと対話します。このクラスは、対象PDF文書を表すPDFileSpecificationオブジェクトを受け取るファイル仕様を設定するためのメソッド（setFile()）と、名前付き宛先文字列、明示的宛先配列、またはページ番号であることができる宛先を定義するためのメソッド（setD()）を提供します。追加のメソッドは、リンク先の文書を新しいビューアーウィンドウで開くかどうかを指定するsetOpenInNewWindow()などの動作を制御します。PDFビューアーがリモートgo-toアクション（通常はリンク注釈やアウトライン項目に関連付けられています）に遭遇すると、ファイル仕様を使用して対象文書を検索して開き、その文書内の指定された宛先へナビゲートします。PDFBoxクラスは、これらのアクションプロパティのシリアル化と逆シリアル化を処理し、開発者が生のPDF辞書構造ではなくJavaオブジェクトを扱えるようにします。

• PDAction – Apache PDFBoxにおけるすべてのPDFアクションタイプの基底クラスで、PDF文書内のインタラクティブな動作を表します
• PDActionGoTo – 同一PDF文書内のナビゲーションアクションを処理するためのApache PDFBoxクラス
• PDFileSpecification – PDF文書内のファイル参照を表すクラスで、外部ファイルを指定するために使用されます
• PDAnnotationLink – ナビゲーション動作を定義するアクションオブジェクトを含むことができるリンク注釈のためのApache PDFBoxクラス
• PDDestination – ナビゲーションアクションによって対象とされる、PDF文書内の特定の場所またはビューを表すインターフェース