À propos de l'API GroupDocs.Annotation pour Java

L’API GroupDocs.Annotation for Java est une bibliothèque qui vous permet d’ajouter des annotations aux documents PDF, Word et autres sur Mac, Windows ou Ubuntu. GroupDocs.Annotation for Java est une API Java native pour la gestion des annotations avec une prise en charge complète pour la création, l’ajout, la modification, la suppression, l’extraction et l’exportation d’annotations à partir d’images et de divers autres documents. La liste complète des formats de documents pris en charge que vous pouvez voir sur cette page. Cette bibliothèque vous permet de travailler non seulement avec le document DOT mais également avec de nombreux autres types de documents tels que Word, Excel, PowerPoint, les e-mails Outlook, Visio, Adobe, OpenDocument, OpenOffice, Photoshop, AutoCad et bien d’autres. L’API GroupDocs.Annotation pour Java vous permet de créer et d’ajouter de nouvelles notes, de modifier des annotations, d’extraire des commentaires, des annotations et de les supprimer des documents. La bibliothèque prend en charge 13 types d’annotations différents, notamment Texte, Polyligne, Zone, Souligné, Point, Filigrane, Flèche, Ellipse, Remplacement de texte, Distance, Champ de texte, Rédaction de ressources en PDF, HTML, documents Microsoft Word, feuilles de calcul, diagrammes, présentations, dessins, images et de nombreux autres formats de fichiers. L’exemple (voir ci-dessous) montre comment travailler avec le document DOT, dans cet exemple, vous pouvez voir les principales étapes de la façon de travailler avec GroupDocs.Annotation : configurer une licence, ouvrir un document avec lequel vous souhaitez travailler, créer un annotation, en ajoutant des objets de données pour définir les propriétés d’annotation en fonction de vos besoins et en enregistrant le résultat à l’endroit requis. Vous pouvez également consulter plus en détail les fonctionnalités prises en charge sur notre page github, ou dans notre produit documentation.

Étapes pour ajouter des annotations à DOT en Java

GroupDocs.Annotation permet aux développeurs Java d’ajouter facilement divers types d’annotations aux fichiers DOT dans n’importe quelle application Java en implémentant quelques étapes simples.

Créez des objets de réponse avec un commentaire et une date.
Créez un objet AreaAnnotation, définissez les options de zone et ajoutez des réponses.
Créez un objet Annotator et ajoutez une annotation de zone.
Enregistrez le fichier de sortie.

Configuration requise

Les API GroupDocs.Annotation pour Java sont prises en charge sur toutes les principales plates-formes et systèmes d’exploitation. Avant d’exécuter le code ci-dessous, assurez-vous que les prérequis suivants sont installés sur votre système.

Systèmes d’exploitation : Microsoft Windows, Linux, MacOS
Environnement de développement : NetBeans, Intellij IDEA, Eclipse, etc.
Environnement d’exécution Java : Java 7 (1.7) et supérieur
Obtenez la dernière version de GroupDocs.Annotation pour Java à partir de GroupDocs Artifact Repository

Aperçu des annotations et exemple de code

// Create an instance of Reply class and add comments
Reply firstReply = new Reply();
firstReply.setComment("First comment");
firstReply.setRepliedOn(Calendar.getInstance().getTime());

Reply secondReply = new Reply();
secondReply.setComment("Second comment");
secondReply.setRepliedOn(Calendar.getInstance().getTime());

List<Reply> replies = new ArrayList<Reply>();
replies.add(firstReply);
replies.add(secondReply);

// Create an instance of AreaAnnotation class and set options
AreaAnnotation area = new AreaAnnotation();
area.setBackgroundColor(65535);
area.setBox(new Rectangle(100, 100, 100, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("This is area annotation");
area.setOpacity(0.7);
area.setPageNumber(0);
area.setPenColor(65535);
area.setPenStyle(PenStyle.Dot);
area.setPenWidth((byte) 3);
area.setReplies(replies);

// Create an instance of Annotator class
Annotator annotator = new Annotator("input.bmp");

// Add annotation
annotator.add(area);

// Save to file
annotator.save("output.bmp");
annotator.dispose();

Annotation preview image

Étapes pour modifier les annotations de DOT en Java

GroupDocs.Annotation permet aux développeurs Java de mettre à jour plus facilement diverses propriétés d’annotation à partir de fichiers DOT dans n’importe quelle application Java en implémentant quelques étapes simples.

Instanciez l’objet Annotator avec le chemin d’accès au document d’entrée ou le flux avec LoadOptions instancié avec ImportAnnotations = true.
Créez une implémentation AnnotationBase et définissez l’ID de l’annotation existante (si l’annotation avec cet ID n’est pas trouvée, rien ne sera modifié) ou la liste des chemins d’annotations (toutes les annotations existantes seront supprimées).
Appelez la méthode de mise à jour de l’objet Annotator avec les annotations transmises.
Appelez la méthode save avec le chemin ou le flux de document résultant et l’objet SaveOptions.

String outputPath = "UpdateAnnotation.bmp";

// Create an instance of Annotator class
Annotator annotator = new Annotator("input.bmp");

// Create an instance of Reply class for first example and add comments
Reply reply1 = new Reply();
reply1.setComment("Original first comment");
reply1.setRepliedOn(Calendar.getInstance().getTime());

Reply reply2 = new Reply();
reply2.setComment("Original second comment");
reply2.setRepliedOn(Calendar.getInstance().getTime());

java.util.List replies = new ArrayList();
replies.add(reply1);
replies.add(reply2);

// Create an instance of AreaAnnotation class and set options
AreaAnnotation original = new AreaAnnotation();
original.setId(1);
original.setBackgroundColor(65535);
original.setBox(new Rectangle(100, 100, 100, 100));
original.setCreatedOn(Calendar.getInstance().getTime());
original.setMessage("This is original annotation");
original.setReplies(replies);

// Add original annotation
annotator.add(original);
annotator.save(outputPath);
annotator.dispose();

LoadOptions loadOptions = new LoadOptions();

// Open annotated document
Annotator annotator1 = new Annotator(outputPath, loadOptions);

// Create an instance of Reply class for update first example
Reply reply3 = new Reply();
reply3.setComment("Updated first comment");
reply3.setRepliedOn(Calendar.getInstance().getTime());

Reply reply4 = new Reply();
reply4.setComment("Updated second comment");
reply4.setRepliedOn(Calendar.getInstance().getTime());

java.util.List replies1 = new ArrayList();
replies1.add(reply3);
replies1.add(reply4);

// Suggest we want change some properties of existed annotation
AreaAnnotation updated = new AreaAnnotation();
updated.setId(1);
updated.setBackgroundColor(255);
updated.setBox(new Rectangle(0, 0, 50, 200));
updated.setCreatedOn(Calendar.getInstance().getTime());
updated.setMessage("This is updated annotation");
updated.setReplies(replies1);

// Update and save annotation
annotator1.update(updated);
annotator1.save(outputPath);
annotator1.dispose();

Étapes pour extraire les annotations de DOT en Java

GroupDocs.Annotation permet aux développeurs Java d’annoter facilement des documents et d’extraire des informations d’annotation à partir de fichiers DOT dans n’importe quelle application Java en implémentant quelques étapes simples.

Créez des objets de réponse avec un commentaire et une date.
Instanciez l’objet LoadOptions et appelez SetImportAnnotations avec l’argument true.
Définissez une variable de type Liste.
Appelez la méthode get et renvoyez le résultat à la variable ci-dessus.

À propos du format de fichier DOT

Les fichiers avec l’extension .DOT sont des fichiers modèles créés par Microsoft Word pour avoir des paramètres pré-formatés pour la génération d’autres fichiers DOC ou DOCX. Un fichier modèle est créé afin d’avoir des paramètres utilisateur spécifiques qui doivent être appliqués aux fichiers suivants créés à partir de ceux-ci. Ces paramètres incluent les marges de page, les bordures, les en-têtes, les pieds de page et d’autres paramètres de page. Ces modèles sont utilisés dans les documents officiels tels que les en-têtes d’entreprise et les formulaires standardisés. Le format de fichier DOT est spécifique à Microsoft Word 2003 et versions antérieures, mais est également pris en charge par les versions supérieures. Microsoft Word ouvre par défaut chaque nouveau document basé sur le fichier normal.dot. S’il est modifié, tous les nouveaux fichiers créés auront les mêmes paramètres que ceux du fichier modèle. Dans Microsoft Word 2007, le format de fichier DOT a été remplacé par le format de fichier DOTX basé sur Office OpenXML.

En savoir plus À propos du format de fichier DOT

Travailler avec d'autres formats de documents courants

Mettez à jour les propriétés d’annotation de certains des formats de fichiers populaires, comme indiqué ci-dessous.

Annoter DOT à partir de Java