Documentation – Ajouter, supprimer et obtenir des annotations PDF en Java

Java: Annotations basées sur du texte utilisant Java

Tue, 22 Sep 2026 00:00:00 +0000

Ajouter une annotation de texte

Ouvrez le PDF d’entrée et ciblez la page où l’annotation de texte doit être placée.
Créez l’objet TextAnnotation, définissez son rectangle et définissez son titre, son sujet, ses indicateurs et sa couleur.
Ajoutez l’annotation à la page et enregistrez le document mis à jour.

public static void textAnnotationAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        TextAnnotation textAnnotation = new TextAnnotation(
                document.getPages().get_Item(1), new Rectangle(299.988, 613.664, 428.708, 680.769, true));
        textAnnotation.setTitle("Aspose User");
        textAnnotation.setSubject("Inserted text 1");
        textAnnotation.setFlags(AnnotationFlags.Print);
        textAnnotation.setColor(Color.getBlue());

        document.getPages().get_Item(1).getAnnotations().add(textAnnotation, false);
        document.save(outputFile.toString());
    }
}

Ajouter une annotation de texte libre

Chargez le PDF source et sélectionnez la page et le rectangle cibles pour la note en texte libre.
Créez l’objet FreeTextAnnotation, initialisez son apparence par défaut et définissez le titre et la couleur.
Ajoutez l’annotation à la page et enregistrez le résultat.

public static void freeTextAnnotationAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        FreeTextAnnotation freeTextAnnotation = new FreeTextAnnotation(
                document.getPages().get_Item(1),
                new Rectangle(299, 713, 308, 720, true),
                new DefaultAppearance());
        freeTextAnnotation.setTitle("Aspose User");
        freeTextAnnotation.setColor(Color.getLightGreen());

        document.getPages().get_Item(1).getAnnotations().add(freeTextAnnotation);
        document.save(outputFile.toString());
    }
}

Java: Annotations de balisage utilisant Java

Tue, 22 Sep 2026 00:00:00 +0000

Ajouter des annotations surlignées, soulignées, ondulées ou barrées

Ouvrez le PDF d’entrée et sélectionnez la zone de page où l’annotation de balisage doit apparaître.
Créez le type d’annotation requis et configurez ses métadonnées ou ses propriétés visuelles.
Ajoutez l’annotation à la collection d’annotations de la page et enregistrez le document.

public static void addTextHighlightAnnotation(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        HighlightAnnotation highlightAnnotation = new HighlightAnnotation(
                document.getPages().get_Item(1), new Rectangle(300, 750, 320, 770, true));
        document.getPages().get_Item(1).getAnnotations().add(highlightAnnotation);
        document.save(outputFile.toString());
    }
}

public static void addTextUnderlineAnnotation(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        UnderlineAnnotation underlineAnnotation = new UnderlineAnnotation(
                document.getPages().get_Item(1), new Rectangle(299.988, 713.664, 308.708, 720.769, true));
        underlineAnnotation.setTitle("Aspose User");
        underlineAnnotation.setSubject("Inserted Underline 1");
        underlineAnnotation.setFlags(AnnotationFlags.Print);
        underlineAnnotation.setColor(Color.getBlue());
        document.getPages().get_Item(1).getAnnotations().add(underlineAnnotation);
        document.save(outputFile.toString());
    }
}

Java: Annotations interactives utilisant Java

Tue, 22 Sep 2026 00:00:00 +0000

Ajouter une annotation de lien

Chargez le document PDF source et recherchez le texte cible dans la première page.
Utilisez le rectangle de texte correspondant pour créer un objet LinkAnnotation et attribuer l’URI de destination.
Ajoutez l’annotation à la page et enregistrez le PDF mis à jour.

public static void linkAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        TextFragmentAbsorber textFragmentAbsorber = new TextFragmentAbsorber("file");
        document.getPages().get_Item(1).accept(textFragmentAbsorber);

        TextFragment phoneNumberFragment = textFragmentAbsorber.getTextFragments().get_Item(1);

        LinkAnnotation linkAnnotation = new LinkAnnotation(
                document.getPages().get_Item(1), phoneNumberFragment.getRectangle());
        linkAnnotation.setAction(new GoToURIAction("www.aspose.com"));

        document.getPages().get_Item(1).getAnnotations().add(linkAnnotation);
        document.save(outputFile.toString());
    }
}

Java: Annotations de forme via Java

Tue, 22 Sep 2026 00:00:00 +0000

Ajouter des annotations de forme

Ouvrez le PDF d’entrée et choisissez la page et le rectangle qui contiendront l’annotation de forme.
Créez l’annotation de forme requise, puis définissez son titre, ses couleurs, son opacité et ses points si nécessaire.
Ajoutez l’annotation à la page et enregistrez le PDF modifié.

public static void squareAnnotationAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        SquareAnnotation squareAnnotation = new SquareAnnotation(
                document.getPages().get_Item(1), new Rectangle(60, 600, 250, 450, true));
        squareAnnotation.setTitle("John Smith");
        squareAnnotation.setColor(Color.getBlue());
        squareAnnotation.setInteriorColor(Color.getBlueViolet());
        squareAnnotation.setOpacity(0.25);

        document.getPages().get_Item(1).getAnnotations().add(squareAnnotation);
        document.save(outputFile.toString());
    }
}

public static void polygonAnnotationAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        PolygonAnnotation polygonAnnotation = new PolygonAnnotation(
                document.getPages().get_Item(1),
                new Rectangle(200, 300, 400, 400, true),
                new Point[]{
                        new Point(200, 300),
                        new Point(220, 300),
                        new Point(250, 330),
                        new Point(300, 304),
                        new Point(300, 400)
                });
        polygonAnnotation.setTitle("John Smith");
        polygonAnnotation.setColor(Color.getBlue());
        polygonAnnotation.setInteriorColor(Color.getBlueViolet());
        polygonAnnotation.setOpacity(0.25);

        document.getPages().get_Item(1).getAnnotations().add(polygonAnnotation);
        document.save(outputFile.toString());
    }
}

Java: Annotations de sécurité utilisant Java

Tue, 22 Sep 2026 00:00:00 +0000

Marquer le texte pour caviardage

Chargez le PDF et recherchez dans toutes les pages le texte qui doit être caviardé.
Créez un objet RedactionAnnotation pour chaque fragment de texte correspondant et configurez son apparence.
Ajoutez les annotations de caviardage à leurs pages et enregistrez le document.

public static void markTextRedaction(Path inputFile, Path outputFile, String searchTerm) {
    try (Document document = new Document(inputFile.toString())) {
        TextFragmentAbsorber textFragmentAbsorber = new TextFragmentAbsorber(searchTerm);
        TextSearchOptions textSearchOptions = new TextSearchOptions(true);
        textFragmentAbsorber.setTextSearchOptions(textSearchOptions);
        document.getPages().accept(textFragmentAbsorber);

        for (TextFragment textFragment : textFragmentAbsorber.getTextFragments()) {
            Page page = textFragment.getPage();
            Rectangle annotationRectangle = textFragment.getRectangle();
            RedactionAnnotation annotation = new RedactionAnnotation(page, annotationRectangle);
            annotation.setFillColor(Color.getGray());
            annotation.setBorderColor(Color.getRed());
            annotation.setColor(Color.getWhite());
            annotation.setOverlayText("REDACTED");
            annotation.setTextAlignment(HorizontalAlignment.Center);
            annotation.setRepeat(true);
            page.getAnnotations().add(annotation, true);
        }

        document.save(outputFile.toString());
    }
}

Java: Annotations en filigrane utilisant Java

Tue, 22 Sep 2026 00:00:00 +0000

Ajouter une annotation en filigrane

Ouvrez le PDF d’entrée et définissez le rectangle où l’annotation en filigrane sera placée.
Créez l’objet WatermarkAnnotation, ajoutez-le à la page et configurez l’état et l’opacité du texte du filigrane.
Appliquez les lignes de texte en filigrane et enregistrez le PDF modifié.

public static void watermarkAdd(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        WatermarkAnnotation watermarkAnnotation = new WatermarkAnnotation(
                document.getPages().get_Item(1), new Rectangle(100, 0, 400, 100, true));

        document.getPages().get_Item(1).getAnnotations().add(watermarkAnnotation);

        TextState textState = new TextState();
        textState.setForegroundColor(Color.getBlue());
        textState.setFontSize(25);
        textState.setFont(FontRepository.findFont("Arial"));

        watermarkAnnotation.setOpacity(0.5);
        watermarkAnnotation.setTextAndState(new String[]{"HELLO", "Line 1", "Line 2"}, textState);

        document.save(outputFile.toString());
    }
}