Vous ajoutez des annotations textuelles dans un fichier PDF pour résumer le contenu écrit dans les documents et noter les points critiques et autres détails. Cependant, vous pouvez ajouter des annotations de texte n’importe où dans le document, et une fois créé, il apparaît sous forme de popup et d’icône lorsqu’il est fermé. Dans cet article de blog, vous apprendrez à ajouter des annotations à un fichier PDF à l’aide de cette API Java pour PDF. De plus, vous passerez en revue les méthodes qui vous aideront à ajouter des annotations de texte dans un fichier par programmation.
Les points suivants seront abordés dans ce guide :
- API Java pour PDF - installation
- Comment ajouter des annotations à un PDF
- Lire les annotations de texte
- Supprimer les annotations de texte
API Java pour PDF - installation
La procédure d’installation de cette bibliothèque n’est qu’à une étape. vous pouvez télécharger l’API ou l’installer à l’aide des configurations Maven suivantes.
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-pdf</artifactId>
<classifier>jdk17</classifier>
</dependency>
Comment ajouter des annotations à un PDF
Désormais, vous pouvez tirer parti des méthodes de cette bibliothèque PDF pour implémenter l’ajout d’annotations de texte à un fichier PDF par programmation.
Veuillez suivre l’extrait de code et les étapes mentionnées ci-dessous :
- Instanciez une instance de la classe Document et chargez le fichier PDF source.
- Obtenez une page par index en appelant la méthode getItem.
- Initialise un objet de la classe Rectangle qui représente un rectangle.
- Créez une nouvelle annotation de texte sur la page spécifiée en créant un objet de la classe TextAnnotation.
- La méthode setTitle définit un texte qui doit être affiché dans la barre de titre de l’annotation.
- La méthode setSubject définit le texte représentant la description de l’objet.
- La méthode setContents définit le texte d’annotation.
- Instanciez le constructeur de l’objet Border avec l’objet textAnnotation.
- Définissez la largeur de la bordure et du motif de tirets en appelant les méthodes setWidth et setDash.
- Appelez la méthode add qui ajoute une annotation à la collection.
- La méthode save enregistre le fichier d’annotation.
Copiez et collez le code suivant dans votre fichier principal :
// Instanciez une instance de la classe Document et chargez le fichier PDF source.
Document document = new Document( "table.pdf");
// Obtenir une page par index en appelant la méthode get_Item
Page page = document.getPages().get_Item(1);
// Initialise un objet de la classe Rectangle qui représente un rectangle.
Rectangle rect = new Rectangle(200, 750, 400, 790);
// Créez une nouvelle annotation Text sur la page spécifiée en créant un objet de la classe TextAnnotation .
TextAnnotation textAnnotation = new TextAnnotation(page, rect);
// La méthode setTitle définit un texte qui doit être affiché dans la barre de titre de l'annotation.
textAnnotation.setTitle("Aspose User");
// La méthode setSubject définit le texte représentant la description de l'objet.
textAnnotation.setSubject("Sample Subject");
// La méthode setContents définit le texte d'annotation.
textAnnotation.setContents("Sample contents for the annotation");
textAnnotation.setOpen(true);
textAnnotation.setIcon(TextIcon.Circle);
// Instanciez le constructeur de l'objet border avec l'objet textAnnotation.
Border border = new Border(textAnnotation);
// Définissez la largeur de la bordure et du motif de tirets en appelant les méthodes setWidth et setDash.
border.setWidth(5);
border.setDash(new Dash(1, 1));
textAnnotation.setBorder(border);
textAnnotation.setRect(rect);
// Appelez la méthode add qui ajoute une annotation à la collection.
page.getAnnotations().add(textAnnotation);
// La méthode d'enregistrement enregistrera le fichier d'annotation.
document.save( "sample_textannot.pdf");
Vous pouvez voir la sortie dans l’image ci-dessous :
Lire les annotations de texte
De même, nous pouvons lire les annotations textuelles d’un fichier PDF existant en suivant les étapes mentionnées ci-dessous :
- Créez une instance de la classe Document et chargez le fichier PDF source.
- Appelez la méthode getItem pour obtenir une page par index.
- Filtrez les annotations à l’aide de AnnotationSelector.
- Appelez la méthode accept pour accepter que le visiteur traite l’annotation.
- Appelez la méthode getSelected pour obtenir la liste des objets Annotation sélectionnés.
- Imprimez les résultats.
Copiez et collez le code suivant dans votre fichier principal :
// créez une instance de la classe Document et chargez le fichier PDF source.
Document document = new Document( "sample_textannot.pdf");
// Appelez la méthode get_Item pour obtenir une page par index en appelant la
Page page = document.getPages().get_Item(1);
// Filtrer les annotations à l'aide d'AnnotationSelector
AnnotationSelector annotationSelector = new AnnotationSelector(
new TextAnnotation(page, Rectangle.getTrivial()));
// Appelez la méthode accept pour accepter que le visiteur traite l'annotation.
page.accept(annotationSelector);
// Appelez la méthode getSelected pour obtenir la liste des objets Annotation sélectionnés.
List<Annotation> TextAnnotations = annotationSelector.getSelected();
// imprimer les résultats
for (Annotation fa : TextAnnotations) {
System.out.println(fa.getRect());
}
Supprimer les annotations de texte
En outre, vous pouvez suivre les étapes et l’extrait de code pour supprimer les annotations textuelles par programmation :
- Créez un objet de la classe Document et chargez le fichier PDF source.
- Filtrez les annotations à l’aide de AnnotationSelector.
- Acceptez que le visiteur traite l’annotation en appelant la méthode accept.
- Appelez la méthode getSelected pour obtenir la liste des objets Annotation sélectionnés.
- Parcourez toutes les annotations de texte et supprimez les annotations en appelant la méthode delete.
- Appelez la méthode save pour enregistrer le fichier.
Copiez et collez le code suivant dans votre fichier principal :
// Créez un objet de la classe Document et chargez le fichier PDF source.
Document document = new Document( "sample_textannot.pdf");
// Filtrer les annotations à l'aide d'AnnotationSelector
Page page = document.getPages().get_Item(1);
AnnotationSelector annotationSelector = new AnnotationSelector(
new TextAnnotation(page, Rectangle.getTrivial()));
// Accepte que le visiteur traite l'annotation en appelant la méthode accept
page.accept(annotationSelector);
// Appelez la méthode getSelected pour obtenir la liste des objets Annotation sélectionnés.
List<Annotation> TextAnnotations = annotationSelector.getSelected();
// parcourir toutes les annotations de texte
for (Annotation fa : TextAnnotations) {
// Supprimer une annotation en appelant la méthode delete
}
// Invoquez la méthode save pour enregistrer le fichier
document.save ( "sample_textannot_del.pdf");
Obtenez une licence gratuite
Vous pouvez bénéficier d’une licence temporaire gratuite pour essayer l’API sans limitation d’évaluation.
Résumé
Cela nous amène à la fin de cet article de blog. Vous avez expliqué comment ajouter des annotations dans un fichier PDF par programmation. En outre, vous avez également appris à lire et à supprimer des annotations de texte à partir de documents PDF existants à l’aide de cette API Java pour PDF. De plus, vous pouvez visiter la documentation pour une exploration plus approfondie des méthodes API.
De plus, nous vous suggérons de suivre notre Guide de démarrage.
Enfin, conholdate.com écrit de nouveaux articles de blog. Par conséquent, veuillez rester en contact pour des mises à jour régulières.
poser une question
Vous pouvez nous faire part de vos questions ou requêtes sur notre forum.
FAQ
Puis-je annoter un PDF gratuitement ?
Veuillez visiter ce lien pour connaître l’extrait de code et les méthodes d’API exposées par Java API pour PDF.