PDAnnotationUnderline

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とは異なります。

PDF文書を扱う開発者にとって、PDAnnotationUnderlineは文書レビューワークフロー、共同編集機能、およびアクセシビリティ強化を実装するための重要な機能を提供します。このクラスを理解することで、開発者は元の文書コンテンツを変更することなく、ユーザーが重要なテキスト部分を強調できるアプリケーションを作成できます。これは法律、教育、およびビジネス文書管理システムにとって不可欠です。アクセシブルな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システム間での注釈の移行が可能になります。

PDAnnotationUnderlineクラスは、PDF文書内のテキスト文字のバウンディングボックスにマッピングされる四角形座標のセットを定義することで機能します。開発者はクラスをインスタンス化し、ページ参照と四角形点配列を含む必要なプロパティを設定し、ページの注釈リストに追加します。四角形点は、各文字または単語グループに対して特定の順序で指定する必要があります：左下隅から始まり、右下、右上、左上の座標の順です。PDFレンダラーはこれらの座標を使用して、指定されたテキスト領域の下に下線ストロークを描画します。主要なプロパティには、色（通常はsetColor()メソッドを使用して設定）、四角形配列（setQuadPoints()を介して設定）、およびPDAnnotation基底クラスから継承された作成日、著者、件名などの標準注釈プロパティが含まれます。注釈アピアランスストリームは、線の太さ、スタイル、および色表現を含む下線の視覚的なレンダリング方法を決定します。適切に構造化された下線注釈は、代替テキスト説明も含み、Tagged PDFガイドライン ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) で指定されている論理的な読み取り順序を維持する必要があります。

• PDAnnotationHighlight – 選択されたテキストに色付きの半透明背景を追加するテキストマークアップ注釈
• PDAnnotationTextMarkup – 下線、ハイライト、取り消し線、波線を含むすべてのテキストマークアップ注釈の親クラス
• PDAnnotationStrikeOut – 削除を示すために選択されたテキストの中央に線を引くテキストマークアップ注釈
• PDPage – 注釈が添付されるPDF文書内の単一ページを表す
• Quad Points – テキストマークアップ注釈でマークされたテキストを包含する矩形領域を定義する座標値の配列