Jak zastąpić tekst w pliku PDF

Jakie parametry akceptuje replaceText?

Sygnatura metody to replaceText(PageSelection pageSelection, String oldText, String newText). Dopasowywanie jest domyslnie uwzgledniajace wielkosc liter: "net6" i "NET6" sa traktowane jako rozne ciagi. Zweryfikuj dokładną wielkość liter w renderowanym PDF przed wywołaniem metody. Możesz potwierdzić dokładny tekst wyodrębniając zawartość tekstową PDF-a najpierw. Zależność IronPDF Java jest opublikowana na Maven Central i wymaga Javy 8 lub nowszej.

 :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");
    }
}

Metoda replaceText naturalnie integruje sie z workflow konwersji HTML do PDF IronPDF. Najpierw renderuj szablon HTML, potem stosuj zamianę tekstu, aby wprowadzić dynamiczne wartości. Dzięki temu Twój HTML jest czysty, podczas gdy nadal produkujesz spersonalizowane wyniki. Dla dokumentow zaladowanych z dysku, przekaz sciezke pliku do PdfDocument.fromFile zamiast uzywac renderHtmlAsPdf.

Jak wygląda wynik?

Jakie strony są modyfikowane, gdy używam listy stron?

W poniższym przykładzie, trzystronicowy PDF jest tworzony z HTML. Wymiana dziala na stronach 0 i 2 (pierwsza i trzecia strona). Strona 1 (druga strona) zachowuje oryginalny tekst bez zmian. Indeksy stron zawsze zaczynaja sie od 0, zgodnie z konwencjami typu array zerowego w Javie.

 :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");
    }
}

Tworzac pdf wielostronicowe z HTML, uzyj wlasciwosci CSS page-break-after, aby kontrolowac, gdzie znajduja sie granice stron. Ustawienie właściwego niestandardowego rozmiaru papieru oraz orientacji strony przed renderowaniem zapewnia, że pozycje treści pasują do Twoich oczekiwań, gdy zamiana tekstu zostanie uruchomiona. Po zapisaniu, zweryfikuj wynik otwierając PDF i potwierdzając, że tylko docelowe strony się zmieniły.

Jak wygląda wynik?

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jakie metody celują w jedną vs. wiele stron?

Kiedy należy używać poszczególnych metod PageSelection?

allPages() jest najprostszym wyborem do globalnej operacji znajdz-i-zamien: kazda wystapienie tekstu docelowego w calej dokumencie jest zastepowane w jedno wywolanie. Uzyj firstPage() lub lastPage() do szybkich poprawek dla stron tytulowych lub stopki ostatniej strony bez dotykania wnetrza. Wybierz pageRange(int, int), gdy tekst pojawia sie na ciagi stron, takich jak rozdzial lub sekcja. Uzyj pageRange(List<Integer>), gdy strony docelowe nie sa ciagle; na przykład, gdy zamieniasz ciąg wersji, który pojawia się tylko na stronach 1, 3 i 7.

Pracując z scalonymi PDF-ami lub dokumentami zawierającymi zakładki i konspekty, najpierw zidentyfikuj zasięg stron dla każdej logicznej sekcji, a następnie zastosuj celowaną zamianę, aby uniknąć przypadkowej modyfikacji wspólnych nagłówków lub stopek. Dokumentacja referencyjna API IronPDF dla Java wymienia wszystkie przeciazenia PageSelection z pelna dokumentacja parametrow.

Jak zamieniam tekst na wszystkich stronach jednocześnie?

PageSelection.allPages() wykonuje wymiane dokumentu w jednym wywolaniu, co jest najbardziej wydajnym sposobem na globalna wymiane tokenow. Przykład poniżej ładuje PDF z dysku i zastępuje każde wystąpienie tokenu zastępczego w całym dokumencie:

 :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");
    }
}

Ten wzorzec naturalnie współgra z szablonowymi przepływami pracy, gdzie ten sam token zastępczy pojawia się w nagłówkach, stopkach lub tekście w wielu stronach. Dla dokumentow jednostronicowych allPages() i firstPage() produkuja identyczne wyniki. Preferuj allPages(), gdy liczba stron moze sie zmieniac w czasie dzialania.

Jak dopasowanie wrażliwe na wielkość liter wpływa na wyniki?

replaceText wykonuje dokladne, uwzgledniajace wielkosc liter dopasowanie. Ciagi "Version 1.0", "version 1.0" i "VERSION 1.0" sa traktowane jako trzy odrebne wartosci. Przed uruchomieniem zamiany na dokumencie załadowanym z dysku, potwierdź dokładną wielkość liter, przeglądając oryginale źródło lub wyodrębniając tekst z PDF-a i analizując go programowo.

Jak zamienić tekst w formularzach PDF?

PDF-y, które zawierają interaktywne pola formularzy, przechowują swoje wartości tekstowe oddzielnie od strumienia treści dokumentu, zgodnie z specyfikacją PDF. Metoda replaceText operuje na przetworzonym strumieniu i nie modyfikuje wartosci pol formularza. Aby zaktualizować tekst wewnątrz pól formularzy, użyj dedykowanego API tworzenia i edytowania formularzy IronPDF. Łączenie obu podejść w tym samym dokumencie jest bezpieczne: aktualizacje pól formularzy i zamiany w strumieniach treści nie wchodzą sobie w drogę.

Jak zaktualizować tekst w przepływach pracy opartych szablonach?

Powszechnym wzorcem jest utrzymywanie szablonu PDF z tokenami miejsce trzymania (na przyklad {{CUSTOMER_NAME}} lub [INVOICE_DATE]) i zastepowanie ich w czasie dzialania rzeczywistymi wartosciami. Wywolaj replaceText raz na miejsce trzymania, uzywajac PageSelection.allPages(), aby zamiana obejmowala kazda lokalizacje, w której pojawia sie token. Dla dokumentow generowanych z HTML, ten workflow dziala rownie dobrze z renderHtmlAsPdf nastepnie z serią wywolan zamieniajacych. Połącz to z znakowaniem PDF lub tłem i pierwszym planem aby dodać markowanie lub oznaczenie poufności do końcowego wyniku.