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

replaceTextが受け取るパラメータは何ですか？

メソッド署名はreplaceText(PageSelection pageSelection, String oldText, String newText)です。 一致はデフォルトで大文字小文字を区別します: "NET6"は異なる文字列として扱われます。 メソッドを呼び出す前に、レンダリングされたPDFの正確なケーシングを確認してください。 まずPDFのテキストコンテンツを抽出することで、正確なテキストを確認できます。IronPDF Java依存関係はMaven Centralに公開されており、Java 8以上が必要です。

 :title=Replace Text on First Page
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-single-page.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;

public class App {

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

        // Set the IronPDF license key (required for production use)
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Render HTML content into a PDF document
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>.NET6</h1>");

        // Define the search and replacement strings
        String oldText = ".NET6";
        String newText = ".NET7";

        // Replace all instances of oldText on the first page only
        // PageSelection.firstPage() targets page index 0
        pdf.replaceText(PageSelection.firstPage(), oldText, newText);

        // Save the modified PDF
        pdf.saveAs("replaceText.pdf");
    }
}

 :title=Replace Text on First Page
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-single-page.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;

public class App {

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

        // Set the IronPDF license key (required for production use)
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Render HTML content into a PDF document
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>.NET6</h1>");

        // Define the search and replacement strings
        String oldText = ".NET6";
        String newText = ".NET7";

        // Replace all instances of oldText on the first page only
        // PageSelection.firstPage() targets page index 0
        pdf.replaceText(PageSelection.firstPage(), oldText, newText);

        // Save the modified PDF
        pdf.saveAs("replaceText.pdf");
    }
}

replaceTextメソッドは、IronPDFのHTMLからPDFへの変換ワークフローと自然に統合されます。 まずHTMLテンプレートをレンダリングし、次に動的な値を注入するためにテキスト置換を適用します。 これにより、HTMLをクリーンに保ちながら、個別化された出力が生成されます。 ディスクからロードされた文書については、PdfDocument.fromFileに渡します。

出力はどのように見えますか?

ページリストを使用したときに変更されるのはどのページですか？

以下の例では、HTMLから3ページのPDFが作成されます。 置換はページ2（最初のページと3ページ目）で実行されます。 ページ1（2ページ目）は元のテキストを変更せずに保持します。 ページインデックスは常に0から始まり、Javaのゼロベースの配列規約と一致しています。

 :title=Replace Text on Multiple Specific Pages
//: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.IOException;
import java.util.Arrays;
import java.util.List;

public class App {

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

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Build a 3-page PDF from HTML using CSS page breaks
        String html = "<p> .NET6 </p>" +
                      "<p> This is 1st Page </p>" +
                      "<div style='page-break-after: always;'></div>" +
                      "<p> This is 2nd Page</p>" +
                      "<div style='page-break-after: always;'></div>" +
                      "<p> .NET6 </p>" +
                      "<p> This is 3rd Page</p>";

        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

        String oldText = ".NET6";
        String newText = ".NET7";

        // Pages are zero-indexed: 0 = first page, 2 = third page
        // Page index 1 (second page) is intentionally excluded
        List<Integer> pages = Arrays.asList(0, 2);

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

        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

 :title=Replace Text on Multiple Specific Pages
//: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.IOException;
import java.util.Arrays;
import java.util.List;

public class App {

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

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Build a 3-page PDF from HTML using CSS page breaks
        String html = "<p> .NET6 </p>" +
                      "<p> This is 1st Page </p>" +
                      "<div style='page-break-after: always;'></div>" +
                      "<p> This is 2nd Page</p>" +
                      "<div style='page-break-after: always;'></div>" +
                      "<p> .NET6 </p>" +
                      "<p> This is 3rd Page</p>";

        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

        String oldText = ".NET6";
        String newText = ".NET7";

        // Pages are zero-indexed: 0 = first page, 2 = third page
        // Page index 1 (second page) is intentionally excluded
        List<Integer> pages = Arrays.asList(0, 2);

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

        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

HTMLからのマルチページPDFを作成するときは、ページの境界がどこにあるかを制御するために、CSS page-break-afterプロパティを使用してください。 カスタム用紙サイズとページ方向をレンダリングの前に設定することで、コンテンツ位置がテキスト置換の際に期待通りになります。 保存後、PDFを開いてターゲットとしたページのみが変更されたことを確認します。

出力はどのように見えますか?

私のお気に入りのこの種のライブラリはIronPDFです。PDFファイルの迅速で効率的な操作が可能です。また、PDF/A形式へのエクスポートやPDF文書へのデジタル署名といった多くの貴重な機能も備えています。

Milan Jovanovic

Microsoft MVP

ケーススタディを見る

IronOCRのおかげで私たちは年間$40,000を手作業の処理から節約し、生産性を向上させ、高影響のタスクにリソースを充てることができます。非常にお勧めします。

Brent Matzelle

最高技術責任者, OPYN

ケーススタディを見る

IronSuiteは私たちの業務において重要な役割を果たしています。これらは、フロアプランの作成や在庫管理の改善を含め、ビジネス全体の効率を向上させるツールです。

David Jones

リードソフトウェアエンジニア、Agorus Build

ケーススタディを見る

単一ページと複数ページをターゲットにするメソッドはどれですか？

それぞれの PageSelection メソッドはいつ使うべきですか?

allPages()は、グローバルな検索と置換に最も簡単な選択です: 文書全体のターゲットテキストのすべてのインスタンスが1回の呼び出しで置換されます。 firstPage() または lastPage() を使用して、ページをカバーするクイック編集や最後のページのフッターを本文に触れずに行います。 章やセクションなど、連続したページにテキストが表示される場合、pageRange(int, int) を選択します。 ページが連続していない場合は pageRange(List<Integer>) を使用します； たとえば、バージョン文字列が1、3、7ページのみに表示される場合です。

結合されたPDF、またはブックマークとアウトラインを含むドキュメントを扱う際には、まず各論理セクションのページ範囲を特定し、それから共有ヘッダーやフッターを誤って変更しないようにターゲットの置換を適用します。 IronPDF for Java API リファレンス には、完全なパラメータドキュメントを備えたすべての PageSelection オーバーロードがリストされています。

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

ドキュメント全体の置換を一度の呼び出しで行う PageSelection.allPages() は、グローバルトークン置換の最も効率的なアプローチです。 以下の例は、ディスクからPDFを読み込み、ドキュメント全体のすべてのプレースホルダートークンを置き換えます。

 :title=Replace Text on All Pages
//: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.IOException;
import java.nio.file.Paths;

public class App {

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

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("contract-template.pdf"));

        // Replace the placeholder token on every page simultaneously
        // This is equivalent to calling replaceText for each page individually
        pdf.replaceText(PageSelection.allPages(), "{{VERSION}}", "2.0");

        // Save the updated document
        pdf.saveAs("contract-v2.pdf");
    }
}

 :title=Replace Text on All Pages
//: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.IOException;
import java.nio.file.Paths;

public class App {

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

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("contract-template.pdf"));

        // Replace the placeholder token on every page simultaneously
        // This is equivalent to calling replaceText for each page individually
        pdf.replaceText(PageSelection.allPages(), "{{VERSION}}", "2.0");

        // Save the updated document
        pdf.saveAs("contract-v2.pdf");
    }
}

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

大文字小文字を区別するマッチングが結果にどのように影響しますか？

replaceText は、厳密で大文字小文字を区別する一致を行います。 文字列 "version 1.0"、および "VERSION 1.0" は、3つの異なる値として扱われます。 ディスクから読み込んだドキュメントに置換を実行する前に、元のソースを確認するか、またはPDFからテキストを抽出することによって正確な大文字小文字を確認してください。

PDFフォームのテキストをどのように置換するか？

インタラクティブなフォームフィールドを含むPDFは、そのテキスト値をPDF仕様で定義されているように、ドキュメントのコンテンツストリームから分離して保存します。 内容ストリームで動作する replaceText メソッドは、フォームフィールドの値を変更しません。 フォームフィールド内のテキストを更新するためには、代わりにIronPDFのフォーム作成と編集APIを使用してください。 同じドキュメントで両方のアプローチを混合することは安全です：フォームフィールドの更新とコンテンツストリームの置換は互いに干渉しません。

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

一般的なパターンとして、プレースホルダートークン (例 {{CUSTOMER_NAME}} または [INVOICE_DATE]) を持つ PDF テンプレートを維持し、実行時に実際の値で置き換えます。 プレースホルダーごとに一度 replaceText を呼び出し、PageSelection.allPages() を使用して、トークンが現れるすべての場所をカバーする置換を行います。 HTMLから生成されたドキュメントの場合、このワークフローは renderHtmlAsPdf の後に一連の置換呼び出しを続けることで同様に機能します。 これをPDFウォーターマークや背景と前景と組み合わせて、最終出力にブランディングや機密標識を追加してください。