如何替換PDF中的文本

replaceText 需要哪些參數？

```java :title=取代文字範例 import com.ironsoftware.ironpdf.*; import com.ironsoftware.ironpdf.edit.PageSelection; 導入 java.io.IOException;

/**

• 主要應用程式類，用於示範如何替換 PDF 中的文字。 */ public class App {

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

  // 設定 IronPDF 許可證金鑰 - 生產環境必需
  License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");
  
  // 將 HTML 內容渲染成 PDF
  // 這會根據 HTML 內容建立一個新的 PDF 文件
  PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>.NET6</h1>");
  
  // 定義要取代的舊文本和新文本
  String oldText = ".NET6";  // 要搜尋的文字
  String newText = ".NET7";  // 取代文字
  
  // 將第一頁所有 oldText 替換為 newText
  // PageSelection.firstPage() 僅針對第一頁（索引 0）
  pdf.replaceText(PageSelection.firstPage(), oldText, newText);
  
  // 儲存產生的 PDF 文檔
  pdf.saveAs("replaceText.pdf");

  } }

所有頁面索引均採用從零開始的索引方式。

replaceText方法預設執行區分大小寫的匹配。 "net6"和"NET6"被視為不同的字串。 在進行HTML 轉 PDF 轉換時，請確保搜尋文字與渲染後的 PDF 中顯示的文字完全一致。 對於更高級的文字操作，可以考慮從 PDF 中提取文字以驗證內容，然後再進行替換。

輸出結果是什麼樣子的？

我可以替換哪些頁面的文字？

import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
導入 java.io.IOException;
import java.util.Arrays;
import java.util.List;

/**
 * Main application class for demonstrating how to replace text on multiple pages of a PDF.
 */
public class App {

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

        // Set the IronPDF license key - see https://ironpdf.com/java/licensing/
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // HTML content that will be converted to a 3-page PDF
        // Page breaks are created using CSS page-break-after property
        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>";

        // Render the HTML content into a PDF
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

        // 定義要取代的舊文本和新文本
        String oldText = ".NET6";
        String newText = ".NET7";

        // Define the pages where text replacement should occur 
        // Page numbers are zero-indexed: 0 = first page, 2 = third page
        List<Integer> pages = Arrays.asList(0, 2);

        // Replace the text on specified pages only
        // The second page (index 1) will remain unchanged
        pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

        // 儲存產生的 PDF 文檔
        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
導入 java.io.IOException;
import java.util.Arrays;
import java.util.List;

/**
 * Main application class for demonstrating how to replace text on multiple pages of a PDF.
 */
public class App {

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

        // Set the IronPDF license key - see https://ironpdf.com/java/licensing/
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // HTML content that will be converted to a 3-page PDF
        // Page breaks are created using CSS page-break-after property
        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>";

        // Render the HTML content into a PDF
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

        // 定義要取代的舊文本和新文本
        String oldText = ".NET6";
        String newText = ".NET7";

        // Define the pages where text replacement should occur 
        // Page numbers are zero-indexed: 0 = first page, 2 = third page
        List<Integer> pages = Arrays.asList(0, 2);

        // Replace the text on specified pages only
        // The second page (index 1) will remain unchanged
        pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

        // 儲存產生的 PDF 文檔
        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

從 HTML 建立多頁 PDF 時，了解自訂 PDF 頁面大小和頁面方向設定有助於確保內容在應用文字取代之前在所有頁面上正確顯示。

替換過程中跳過頁面會發生什麼？

哪些方法針對單一頁面，哪些方法針對多個頁面？

• allPages ：選擇 PDF 的所有頁面
• firstPage ：選擇 PDF 檔案的第一頁。
• lastPage ：選擇 PDF 的最後一頁
• pageRange(int startIndex, int endIndex) : 指定頁面範圍（例如， 0到2選擇1到3頁）
• pageRange(List<Integer> pageList) ：從清單中選擇特定頁面（例如， [0, 2]選擇1頁和3頁）
• singlePage(int pageIndex) ：指定 PDF 的單一頁面。

我應該在什麼情況下使用哪種頁面選擇方法？

使用firstPage()或lastPage()可以快速編輯文件的頁首和頁尾。 當需要更新多個連續頁面（例如章節）時，請選擇pageRange() 。 選擇singlePage()進行針對性更正，應用allPages()對整個文件進行全域查找和替換操作。

處理合併的 PDF時，使用pageRange()僅更新特定來源文件中的頁面。 同樣地，在處理具有書籤和大綱的文件時，可以使用頁面範圍來定位特定部分。