À 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 DOCM 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 DOCM, 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 à DOCM en Java

GroupDocs.Annotation permet aux développeurs Java d’ajouter facilement divers types d’annotations aux fichiers DOCM 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 DOCM en Java

GroupDocs.Annotation permet aux développeurs Java de mettre à jour plus facilement diverses propriétés d’annotation à partir de fichiers DOCM 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 DOCM en Java

GroupDocs.Annotation permet aux développeurs Java d’annoter facilement des documents et d’extraire des informations d’annotation à partir de fichiers DOCM 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 DOCM

Les fichiers DOCM sont des documents générés par Microsoft Word 2007 ou supérieur avec la possibilité d’exécuter des macros. Il est similaire au format de fichier DOCX mais la possibilité d’exécuter des macros le rend différent de DOCX. Comme DOCX, les fichiers DOCM peuvent stocker du texte, des images, des tableaux, des formes, des graphiques et d’autres contenus. La possibilité d’exécuter des macros permet de gagner du temps en exécutant la série de commandes sous la forme d’actions enregistrées pour l’achèvement automatique d’une tâche. . Les fichiers DOCM peuvent être ouverts et modifiés dans Microsoft Word 2007 et supérieur.

En savoir plus À propos du format de fichier DOCM

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 DOCM à partir de Java