PDF内のテキストを置換する方法

ページリストを使用する際、どのページが変更されますか？

以下の例では、HTMLから3ページのPDFが生成されています。 置換対象は、0 および 2 のページ（1ページ目と3ページ目）です。 ページ 1（2ページ目）は、原文をそのまま維持します。 ページインデックスは、Javaの0ベースの配列表記規則に準拠し、常に 0 から始まります。

```java :title=特定の複数のページ上のテキストを置換する //:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-multiple-pages.java import com.ironsoftware.IronPDF.*; import com.ironsoftware.IronPDF.edit.PageSelection; import java.io.IO/Exception; import java.util.Arrays; import java.util.List;

public class App {

public static void main(String[] args) throws IOException {

    // IronPDFのライセンスキーを設定する
    License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

    // CSSの改ページ機能を使用して、HTMLから3ページのPDFを作成する
    String html = &quot;<p> .NET 6 </p>&quot; +
                  &quot;<p> これは1ページ目です </p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> これは2ページ目です</p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> .NET 6 </p>&quot; +
                  &quot;<p> これは3ページ目です</p>&quot;;

    PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

    String oldText = &quot;.NET6&quot;;
    String newText = &quot;.NET7&quot;;

    // ページ番号は0から始まります：0 = 1ページ目、2 = 3ページ目
    // ページインデックス 1（2ページ目）は意図的に除外されています
    List<integer> pages = Arrays.asList(0, 2);</integer>

    pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

    pdf.saveAs(&quot;replaceTextOnMultiplePages.pdf&quot;);
}

}

ご注意IronPDF のすべてのページインデックスは、0 ベースのインデックス付けに従います。 ページ `0` は最初のページ、ページ `1` は 2 ページ目、というように続きます。）}]

HTMLから複数ページのPDFを作成する際は、[CSS](https://developer.mozilla.org/en-US/docs/Web/CSS/page-break-after)の[`page-break-after`プロパティ](https://developer.mozilla.org/en-US/docs/Web/CSS/page-break-after)を使用して、ページ境界の位置を制御してください。 レンダリング前に適切な[カスタム用紙サイズ](https://ironpdf.com/java/examples/custom-pdf-paper-size/)と[ページ向き](https://ironpdf.com/java/examples/pdf-page-orientation/)を設定することで、テキスト置換の実行時にコンテンツの位置が期待どおりになることが保証されます。 保存後、PDFを開いて、対象のページのみが変更されていることを確認し、出力を検証してください。

### 翻訳後の出力はどのようなものになりますか？

<iframe loading="lazy" src="/static-assets/ironpdf-java/howto/find-replace-text/replaceTextOnMultiplePages.pdf" width="100%" height="400px"></iframe>

<hr>

## 利用可能なページ選択オプションにはどのようなものがありますか？

`PageSelection` クラスは、一般的なターゲティングパターンをすべて網羅する静的ファクトリメソッドを提供します。 インスタンスの作成は不要です； クラス上でメソッドを直接呼び出します。 すべてのインデックスは0から始まります。

### どのメソッドが単一ページを対象とし、どのメソッドが複数ページを対象としていますか？

<table class="content__data-table" data-content-table>
<caption>replaceText API の PageSelection ファクトリメソッド</caption>

| 方法 | 説明 |
|---|---|
| `PageSelection.allPages()` | ドキュメント内のすべてのページを選択します |
| `PageSelection.firstPage()` | index ページの選択 `0` |
| `PageSelection.lastPage()` | ドキュメントの長さにかかわらず、最終ページを選択します |
| `PageSelection.singlePage(int pageIndex)` | 0を起点とするインデックスで特定のページを1つ選択します |
| `PageSelection.pageRange(int startIndex, int endIndex)` | `startIndex` から `endIndex` までの連続した範囲を選択します（両端を含む） |
| `PageSelection.pageRange(List<Integer> pageList)` | 任意のインデックスの組み合わせでページを選択します（例：`[0, 2]` は 1 ページ目と 3 ページ目を選択します）。 |

</table>

### 各 PageSelection メソッドはいつ使用すべきですか？

`allPages()` は、文書全体にわたるターゲットテキストを一度の呼び出しで一括置換できる、最もシンプルなグローバル置換の選択肢です。 本文に触れずに表紙や最終ページのフッターを素早く編集するには、`firstPage()` または `lastPage()` を使用してください。 章やセクションなど、連続したページにテキストが表示される場合は、`pageRange(int, int)` を選択してください。 対象ページが連続していない場合は、`pageRange(List<Integer>)`を使用してください。 例えば、1ページ目、3ページ目、7ページ目のみに表示されるバージョン文字列を置換する場合など。

[結合されたPDF](https://ironpdf.com/java/examples/split-pdfs/)や、[ブックマークやアウトライン](https://ironpdf.com/java/how-to/bookmarks/)を含むドキュメントを扱う場合は、まず各論理セクションのページ範囲を特定し、共有されているヘッダーやフッターを誤って変更しないよう、対象を絞った置換を行ってください。 [IronPDF for Java APIリファレンス](https://ironpdf.com/object-reference/api/)には、すべての`PageSelection`オーバーロードと、完全なパラメータのドキュメントが記載されています。

重要Wrap `replaceText` の呼び出しを try-catch ブロックで囲みます。 このメソッドは、指定された検索テキストが対象ページ内のいずれにも見つからない場合、ランタイム例外をスローします。 検証ステップ（テキストを抽出し、その文字列が存在することを確認する）により、本番環境での予期せぬ障害を防止します。}}]

### すべてのページのテキストを一度に置き換えるにはどうすればよいですか？

`PageSelection.allPages()` は、1回の呼び出しでドキュメント全体にわたる置換を実行します。これは、グローバルなトークン置換を行う上で最も効率的なアプローチです。 以下の例では、ディスクからPDFを読み込み、ドキュメント全体にわたってプレースホルダートークンが使用されている箇所をすべて置換しています：

```java :title=全ページのテキストを置換
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-all-pages.java
import com.ironsoftware.IronPDF.*;
import com.ironsoftware.IronPDF.edit.PageSelection;
import java.io.IO/Exception;
import java.nio.file.Paths;

public class App {

    public static void main(String[] args) throws IOException {

        // IronPDFのライセンスキーを設定する
        License.setLicenseKey(&quot;IronPDF-MYLICENSE-KEY-1EF01&quot;);

        // ディスクから既存のPDFを読み込む
        PdfDocument pdf = PdfDocument.fromFile(Paths.get(&quot;contract-template.pdf&quot;));

        // すべてのページでプレースホルダトークンを同時に置換する
        // これは、各ページに対して個別にreplaceTextを呼び出すのと同じです
        pdf.replaceText(PageSelection.allPages(), &quot;{{VERSION}}&quot;, &quot;2.0&quot;);

        // 更新されたドキュメントを保存
        pdf.saveAs(&quot;contract-v2.pdf&quot;);
    }
}

このパターンは、多くのページにわたってヘッダー、フッター、または本文に同じプレースホルダーが表示される、テンプレート駆動型のワークフローと自然に組み合わされます。 1ページのドキュメントの場合、allPages() と firstPage() は同じ結果になります。 実行時にページ数が変動する可能性がある場合は、allPages()を使用することを推奨します。

大文字小文字を区別する検索は結果にどのような影響を与えますか？

replaceText は、大文字と小文字を区別した完全一致検索を行います。 文字列 "version 1.0"、および "VERSION 1.0" は、それぞれ独立した値として扱われます。 ディスクから読み込んだドキュメントに対して置換処理を実行する前に、元のソースを確認するか、PDFからテキストを抽出してプログラムで検証し、大文字小文字の正確性を確認してください。

PDFフォーム内のテキストを置き換えるにはどうすればよいですか？

PDF仕様で定義されているように、インタラクティブなフォームフィールドを含むPDFでは、テキスト値はドキュメントのコンテンツストリームとは別に保存されます。 replaceText メソッドはコンテンツストリームに対して動作し、フォームフィールドの値を変更することはありません。 フォームフィールド内のテキストを更新するには、代わりにIronPDFの専用のフォーム作成および編集APIを使用してください。 同じドキュメント内で両方のアプローチを併用しても問題ありません。フォームフィールドの更新とコンテンツストリームの置換は、互いに干渉しません。

テンプレートベースのワークフローでテキストを更新するにはどうすればよいですか？

一般的な手法として、プレースホルダトークン（例：{{CUSTOMER_NAME}} や [INVOICE_DATE]）を含むPDFテンプレートを用意し、実行時にそれらを実際の値に置き換える方法があります。 プレースホルダーごとに replaceText を 1 回呼び出し、PageSelection.allPages() を使用して、トークンが出現するすべての箇所が置換されるようにしてください。 HTMLから生成されたドキュメントの場合、このワークフローは、renderHtmlAsPdf の後に一連の置換呼び出しが続く形式でも同様に機能します。 これにPDFの透かしや背景・前景を組み合わせることで、最終出力物にブランドマークや機密表示を追加できます。