Comment remplacer du texte dans un PDF

Quels paramètres replaceText accepte-t-il ?

La signature de méthode est replaceText(PageSelection pageSelection, String oldText, String newText). La correspondance est sensible à la casse par défaut : "net6" et "NET6" sont traités comme des chaînes différentes. Vérifiez l'exactitude de la casse dans le PDF rendu avant d'appeler la méthode. Vous pouvez confirmer le texte exact en extrayant d'abord le contenu texte du PDF. La dépendance IronPDF Java est publiée sur Maven Central et nécessite Java 8 ou une version ultérieure.

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

La méthode replaceText s'intègre naturellement avec le workflow de conversion HTML en PDF d'IronPDF. Rendez d'abord le modèle HTML, puis appliquez le remplacement de texte pour injecter des valeurs dynamiques. Cela maintient votre HTML propre tout en produisant le résultat personnalisé. Pour les documents chargés à partir du disque, passez le chemin du fichier à PdfDocument.fromFile au lieu d'utiliser renderHtmlAsPdf.

À quoi ressemble le résultat ?

Quelles pages sont modifiées lors de l'utilisation d'une liste de pages ?

Dans l'exemple ci-dessous, un PDF de trois pages est créé à partir de HTML. Le remplacement s'exécute sur les pages 0 et 2 (les première et troisième pages). La page 1 (la deuxième page) conserve le texte original inchangé. Les index de page commencent toujours à 0, conformément aux conventions de tableau indexé à zéro de 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");
    }
}

Lorsque vous créez des PDF multi-pages à partir de HTML, utilisez la propriété CSS page-break-after pour contrôler où tombent les limites de page. Définir la taille de papier personnalisée et l'orientation de page appropriées avant le rendu garantit que les positions de contenu correspondent à vos attentes lors de l'exécution du remplacement de texte. Après avoir enregistré, vérifiez la sortie en ouvrant le PDF et en confirmant que seules les pages ciblées ont changé.

À quoi ressemble le résultat ?

Ma bibliothèque préférée de ce genre est IronPDF. Elle permet une manipulation rapide et efficace des fichiers PDF. Elle dispose également de nombreuses fonctionnalités précieuses, comme l'exportation au format PDF/A et la signature numérique des documents PDF.

Milan Jovanovic

Microsoft MVP

Voir l'étude de cas

IronOCR signifie que nous pouvons économiser 40 000 $ par an grâce au traitement manuel, tout en améliorant la productivité et en libérant des ressources pour des tâches à fort impact. Je le recommande vivement.

Brent Matzelle

Directeur technique, OPYN

Voir l'étude de cas

Iron Suite joue un rôle crucial dans nos opérations. Ce sont des outils qui augmentent l'efficacité de l'entreprise, y compris la création de plans d'étage et l'amélioration de la gestion des stocks.

David Jones

Ingénieur logiciel principal, Agorus Build

Voir l'étude de cas

Quelles méthodes ciblent une seule page ou plusieurs pages ?

Quand devrais-je utiliser chaque méthode PageSelection?

allPages() est le choix le plus simple pour une recherche et remplacement global : chaque instance du texte cible à travers le document entier est remplacée en un seul appel. Utilisez firstPage() ou lastPage() pour des modifications rapides des pages de couverture ou des bas de page de dernière page sans toucher au corps. Choisissez pageRange(int, int) lorsque le texte apparaît sur un ensemble de pages séquentielles telles qu'un chapitre ou une section. Utilisez pageRange(List<Integer>) lorsque les pages cibles ne sont pas contiguës ; par exemple, lors du remplacement d'une chaîne de version qui n'apparaît que sur les pages 1, 3, et 7.

Lorsque vous travaillez avec des PDFs fusionnés ou des documents qui incluent des signets et contours, identifie d'abord la plage de pages pour chaque section logique, puis applique des remplacements ciblés pour éviter de modifier accidentellement les en-têtes ou pieds de page partagés. La référence API IronPDF for Java liste toutes les surcharges PageSelection avec documentation complète des paramètres.

Comment remplacer le texte sur toutes les pages en une seule fois ?

PageSelection.allPages() effectue un remplacement sur l'ensemble du document en un seul appel, ce qui est l'approche la plus efficace pour une substitution globale de jeton. L'exemple ci-dessous charge un PDF depuis le disque et remplace chaque occurrence d'un jeton de remplacement à l'échelle de l'ensemble du document :

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

Ce modèle s'associe naturellement à des flux de travail basés sur des modèles où le même espace réservé apparaît dans les en-têtes, les pieds de page ou le texte du corps sur plusieurs pages. Pour les documents d'une seule page, allPages() et firstPage() produisent des résultats identiques. Préférez allPages() lorsque le nombre de pages peut varier à l'exécution.

Comment la correspondance sensible à la casse influence-t-elle les résultats ?

replaceText réalise des correspondances exactes, sensibles à la casse. Les chaînes "Version 1.0", "version 1.0", et "VERSION 1.0" sont traitées comme trois valeurs distinctes. Avant d'exécuter un remplacement sur un document chargé depuis le disque, confirmez exactement la casse en examinant la source originale ou en extrayant le texte du PDF et en l'inspectant par programmation.

Comment puis-je remplacer le texte dans les formulaires PDF ?

Les PDF contenant des champs de formulaire interactifs stockent leurs valeurs de texte séparément du flux de contenu du document, tel que défini dans la spécification PDF. La méthode replaceText fonctionne sur le flux de contenu et ne modifie pas les valeurs des champs de formulaire. Pour mettre à jour le texte à l'intérieur des champs de formulaire, utilisez plutôt l'API de création et d'édition de formulaire d'IronPDF. Mélanger les deux approches dans le même document est sans danger : les mises à jour des champs de formulaire et les remplacements de flux de contenu n'interfèrent pas entre elles.

Comment puis-je mettre à jour le texte dans les flux de travail basés sur des modèles ?

Un modèle courant est de maintenir un modèle PDF avec des jetons de remplacement (par exemple {{CUSTOMER_NAME}} ou [INVOICE_DATE]) et de les remplacer à l'exécution par des valeurs réelles. Appelez replaceText une fois par espace réservé, en utilisant PageSelection.allPages() pour que le remplacement couvre chaque emplacement où le jeton apparaît. Pour les documents générés à partir de HTML, ce workflow fonctionne également bien avec renderHtmlAsPdf suivi d'une série d'appels de remplacement. Combinez cela avec le filigrane PDF ou les arrière-plans et avant-plans pour ajouter des marques de marque ou de confidentialité au résultat final.