PDAnnotationStrikeout

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を持つ注釈オブジェクトを作成し、選択されたテキスト範囲に水平線を引いてレンダリングします。コンテンツを永続的に削除する墨消し注釈とは異なり、取り消し線注釈は非破壊的なマークアップであり、削除提案を視覚的に示しながら元のテキストを保持します。このクラスは、取り消し線を引くべきテキスト領域を定義する四角形座標を設定するメソッドと、色、作成者、変更日などの標準的な注釈プロパティを提供します。

文書レビュー、コラボレーション、または編集ワークフローを構築する開発者にとって、PDAnnotationStrikeoutは文書から実際にテキストを削除することなく、削除マークを付けるための重要な機能を提供します。これは、提案された変更の追跡や監査証跡の維持が求められる法務、学術、ビジネス環境において極めて重要です。取り消し線注釈をプログラム的に追加する機能により、一括赤入れ、変更追跡システム、特定のテキストパターンを削除対象としてフラグ付けする必要があるコンプライアンスワークフローなど、自動化された文書処理シナリオが可能になります。さらに、 ( 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を扱う場合、適切に実装されたテキストマークアップ注釈は文書構造と編集意図を支援技術に伝えることができますが、アクセシビリティが要件である場合、開発者は注釈が適切にタグ付けされていることを確認する必要があります。

PDAnnotationStrikeoutは、取り消し線を引くテキストを包含する矩形領域（四角形）を定義し、PDFレンダラーが指定された各領域の中央を通る水平線を描画することで動作します。開発者はPDAnnotationStrikeoutのインスタンスを作成し、テキスト境界を定義するために四角形ポイント配列を設定し、それをPDPageの注釈リストに追加します。四角形はPDF座標空間（左下が原点）で指定され、マークするテキスト領域の4つの角を表す8つの値の配列として表されます。注釈は、線の色（通常は赤または黒）、不透明度、削除理由を説明するポップアップノート、作成者やタイムスタンプなどのメタデータといったプロパティでカスタマイズできます。PDFがレンダリングされる際、準拠するビューアは注釈の外観ストリームに従って取り消し線をテキスト上に表示します。この外観ストリームはPDFBoxが自動的に生成することも、開発者がカスタマイズすることもできます。元のテキストは完全に検索・選択可能なまま保持され、注釈は標準的なPDFレビューワークフローを通じて編集、削除、承認/却下が可能です。取り消し線注釈はコンテンツストリームではなく文書の注釈レイヤーの一部であるため、元のテキストに影響を与えることなく簡単にフィルタリング、エクスポート、または削除でき、非破壊的な編集シナリオに最適です。

• PDAnnotationMarkup – 取り消し線、ハイライト、下線を含むすべてのテキストマークアップ注釈の親クラス
• PDAnnotationTextMarkup – 文書内のテキスト範囲をマークする注釈の基底クラス
• PDAnnotation – Apache PDFBoxにおけるすべての注釈タイプのルート抽象クラス
• Text Markup Annotation – テキスト範囲の外観を視覚的に強調または変更する注釈の総称
• Redaction Annotation – 非破壊的な取り消し線とは対照的に、コンテンツを永続的に削除する破壊的な注釈タイプ