PDAnnotationStrikeoutは、Apache PDFBoxライブラリにおいて、PDF文書内の取り消し線テキストマークアップ注釈を表す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
)
によれば、取り消し線のようなテキストマークアップ注釈は、レビューおよび編集ワークフローにおいて文書コンテンツをマークアップするために使用されます。
PDAnnotationStrikeoutは、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
)
で定義されている4つの標準的なテキストマークアップタイプ(ハイライト、下線、波線と並んで)の1つです。インスタンス化されると、このクラスはサブタイプ/StrikeOutを持つ注釈オブジェクトを作成し、選択されたテキスト範囲に水平線を引いてレンダリングします。コンテンツを永続的に削除する墨消し注釈とは異なり、取り消し線注釈は非破壊的なマークアップであり、削除提案を視覚的に示しながら元のテキストを保持します。このクラスは、取り消し線を引くべきテキスト領域を定義する四角形座標を設定するメソッドと、色、作成者、変更日などの標準的な注釈プロパティを提供します。
PDAnnotationTextは、Apache PDFBox PDModel APIに含まれるJavaクラスで、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
)
で定義されているように、基本となるドキュメントコンテンツを変更することなく、PDF内の特定の位置にテキストコメントやノートを添付できます。このクラスは、コンテンツ、アイコンタイプ、開閉状態、視覚的外観などのテキスト注釈プロパティを作成、読み取り、変更するためのメソッドを提供します。
PDAnnotationTextは、Apache PDFBoxの高レベルPDModel API階層内の具象実装クラスで、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
)
で定義されている標準的な注釈タイプの一つであるテキスト注釈を専門的に扱います。通常はドキュメントコンテンツに関連付けられるマークアップ注釈とは異なり、テキスト注釈はページ上のどこにでも配置できる独立したノートアイコンです。クリックすると、注釈のテキストコンテンツを含むポップアップウィンドウが表示されます。
PDAnnotationTextMarkupは、Apache PDFBoxライブラリにおいて、PDFドキュメント内のテキストマークアップ注釈を表現する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
)
で定義されているように、ユーザーは基礎となるテキスト自体を変更することなく、テキストコンテンツをハイライト、下線、取り消し線、または波線下線で装飾できます。このクラスは、これらの視覚的なマークアップ要素をプログラム的に作成、読み取り、変更するためのメソッドを提供します。テキストマークアップ注釈は、アクセシビリティ機能やドキュメントレビューワークフローにおいて特に重要です。
PDAnnotationTextMarkupは、Apache PDFBoxのPDModel API内の具体的な実装クラスであり、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
)
で定義されているテキストマークアップ注釈を処理します。このクラスはPDAnnotation基底クラスを拡張し、Highlight(ハイライト)、Underline(下線)、StrikeOut(取り消し線)、Squiggly(波線)という4つのテキストマークアップサブタイプを管理します。実際のコンテンツストリームを変更するテキスト編集操作とは異なり、テキストマークアップ注釈は元のコンテンツを保持したまま、既存のテキスト上に視覚的なインジケーターを重ねます。このクラスは、テキスト領域上にマークアップを正確に配置するために必要な複雑な座標系と四辺形定義をカプセル化しており、
(
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
)
で概説されているアクセシビリティコンプライアンスにおいて特に重要です。
PDAnnotationUnderlineは、Apache PDFBox 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
)
。下線注釈はテキストマークアップ注釈ファミリーの一部であり、文書レビュー、共同作業、およびアクセシビリティ目的で一般的に使用されます。
PDAnnotationUnderlineは、Apache PDFBoxの注釈API階層における具体的な実装クラスであり、下線スタイルのテキストマークアップ注釈を専門的に処理します。ハイライトや取り消し線などの他のテキストマークアップ注釈とは異なり、下線注釈は選択されたテキスト領域の下に線としてレンダリングされます。このクラスはPDAnnotationTextMarkup親クラスを拡張し、下線を引くべきテキストを指定する四角形の点を定義するメソッドを提供します。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
)
によると、下線注釈はマークされるテキストを包含する四角形を定義する必要があり、視覚的なレンダリングはマークされたテキストのベースラインの下に線として表示されます。これは、色付きの背景を追加するPDAnnotationHighlightや、テキストの中央に線を引くPDAnnotationStrikeOutとは異なります。
PDAnnotationUnknownは、Apache PDFBox PDModel APIにおける特殊なクラスで、PDFBoxライブラリが明示的に認識またはサポートしていないアノテーション型を表します。PDFBoxが定義済みのアノテーションクラスのいずれにも一致しないアノテーションサブタイプに遭遇した場合、PDAnnotationUnknownオブジェクトをインスタンス化し、解釈せずにアノテーションデータを保持します。これにより、
(
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文書は、PDFBoxが実装していないカスタムまたは新しいアノテーション型を含む場合でも、読み取りと処理が可能になります。
PDAnnotationUnknownは、Apache PDFBoxのオブジェクト指向アノテーション階層におけるフォールバッククラスです。PDF仕様では多数の標準アノテーションサブタイプ(Text、Link、FreeText、Widgetアノテーションなど)が定義されていますが、カスタムアノテーションサブタイプも許可されており、将来の拡張に対する規定も含まれています。PDFBoxがPDF文書を解析し、認識できないサブタイプを持つアノテーションに遭遇した場合、エラーをスローしたりアノテーションを破棄したりするのではなく、PDAnnotationUnknownインスタンスを作成します。
このクラスは、アノテーション固有のプロパティに対する特殊なgetterおよびsetterメソッドを提供しないという点で、他のPDAnnotationサブクラスとは異なります。代わりに、PDFファイルから取得した生の辞書エントリを保持し、開発者が汎用の辞書メソッドを使用してアノテーションのプロパティにアクセスおよび変更できるようにします。このアプローチにより、後方互換性と前方互換性が確保されます。つまり、PDFBoxは、ライブラリの更新を必要とせずに、PDF仕様の新しいバージョンや独自拡張からのアノテーションを含むPDFを処理できます。
多様なPDF文書を扱う開発者にとって、PDAnnotationUnknownは文書の整合性を維持し、データ損失を防ぐ上で重要な役割を果たします。カスタムアノテーション、業界固有の特殊なマークアップ、または新しいPDFバージョンの機能を含む可能性のあるPDFを処理する際、このクラスは以下を保証します。
PDAnnotationWidgetは、Apache PDFBox PDModel APIにおいて、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
)
で定義されているインタラクティブフォームフィールドの視覚的表現です。このクラスは、テキストボックス、チェックボックス、ラジオボタン、ドロップダウンリストなどのフォームコントロールの外観とプロパティに、プログラムからアクセスし操作するためのメソッドを開発者に提供します。
PDAnnotationWidgetは、Apache PDFBox内の高レベルJavaクラスで、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
)
によると、ウィジェット注釈はフォームフィールドのグラフィカル表現として機能し、現在の値を表示してユーザーインタラクションを可能にします。ドキュメントにコメントやマークアップを追加する他の注釈タイプとは異なり、ウィジェット注釈は特にAcroFormフィールドと結び付けられており、ユーザーがPDFフォームに記入する際に見て操作するインタラクティブ要素を表します。
PDAppearanceCharacteristicsDictionaryは、Apache PDFBoxにおける高レベルAPIクラスであり、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
)
で定義されている外観特性辞書構造に対応しており、インタラクティブなフォーム要素の背景色、境界線色、回転、キャプションテキストなどの視覚的プロパティを制御します。これにより、開発者はフォームウィジェットや注釈の核となる機能を変更することなく、ユーザーへの表示方法を読み取りおよび変更することができます。
PDAppearanceCharacteristicsDictionaryは、Apache PDFBoxのPDModelパッケージの一部であり、
(
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外観特性辞書(MKエントリ)をラップします。実際にレンダリングされるコンテンツを定義する外観ストリームとは異なり、外観特性辞書には、外観ストリームの生成方法やウィジェットの表示方法に影響を与えるメタデータとパラメータが含まれています。このクラスは、回転角度、境界線スタイル、背景色、通常キャプション、ロールオーバーキャプション、代替キャプション、通常アイコン、ロールオーバーアイコン、代替アイコン、アイコンフィット、キャプション配置などのプロパティに対するgetterおよびsetterメソッドを提供します。
PDAppearanceDictionaryは、Apache PDFBox PDModel APIにおける高レベルクラスで、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
)
で規定されているように、インタラクティブなフォームフィールドやアノテーションの視覚的表現を定義します。このクラスにより、開発者はPDF要素が画面上や印刷時にどのようにレンダリングされるかを制御するアピアランスストリームの読み取り、作成、変更が可能になります。
PDAppearanceDictionaryは、PDF仕様で定義されているアピアランス辞書構造を表すJavaクラスラッパーです。PDF文書において、アピアランス辞書には、アノテーションやフォームフィールドが異なる条件下(通常状態、ロールオーバー状態、ダウン状態)でどのように表示されるべきかを定義する1つ以上のアピアランスストリームが含まれます。PDAppearanceDictionaryクラスは、PDFBoxの低レベルCOS(Carousel Object System)レイヤーを抽象化し、PDF構文を直接扱うことなく、これらのアピアランスストリームにアクセスして操作するための型安全なメソッドを提供します。直接的なCOS辞書操作とは異なり、このクラスはアピアランス関連の操作専用に設計された便利なメソッドを提供し、
(
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
)
で定義されている複雑なアピアランスストリーム階層を扱いやすくします。
PDAppearanceEntryは、Apache PDFBox PDModel APIのクラスであり、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
)
で規定されているように、PDFドキュメント内のフォームフィールド、注釈、およびインタラクティブ要素がどのように視覚的にレンダリングされるかを定義します。このクラスは、PDFオブジェクトの視覚的表現を制御するアピアランスストリームにアクセスし、操作するための高レベルなメソッドを開発者に提供します。
PDAppearanceEntryは、PDFのアピアランス辞書構造内の単一のアピアランスストリームエントリをカプセル化するJavaクラスです。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
)
では、アピアランスは通常(N)、ロールオーバー(R)、ダウン(D)の状態を含む辞書として構成されており、PDAppearanceEntryはこれらのアピアランス状態の1つを表します。PDF構文を直接扱うPDFBoxの低レベルなCOS(Carousel Object System)オブジェクトとは異なり、PDAppearanceEntryは、PDFの内部構造に関する詳細な知識を必要とせずにアピアランスストリームを扱うための開発者にとって使いやすい抽象化レイヤーを提供します。
PDAppearanceStreamは、Apache PDFBox PDModel APIのクラスで、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
)
で規定されているように、注釈、フォームフィールド、その他のインタラクティブ要素の視覚的表現を定義します。この高レベルJavaクラスは、開発者がこれらのPDF要素のレンダリング時の表示方法を決定するグラフィカルコンテンツを読み取り、作成、変更するためのメソッドを提供します。
PDAppearanceStreamは、Apache PDFBoxのorg.apache.pdfbox.pdmodel.interactive.annotationパッケージに含まれる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
)
において、アピアランスストリームは特殊なフォームXObjectで、注釈、フォームウィジェット、署名フィールドの視覚的外観をレンダリングするために必要なコンテンツストリームとリソースを含みます。ページの静的コンテンツを定義する一般的なコンテンツストリームとは異なり、アピアランスストリームはインタラクティブ要素に特化して関連付けられ、複数の状態(例えば、ボタンの通常、ロールオーバー、押下状態)を持つことができます。