Annotaties worden normaal gesproken gebruikt om fouten in documenten te vermelden of om de inhoud ervan te bespreken. Met annotaties kunt u lange en eindeloze discussies binnen e-mailthreads vermijden. In dit artikel leert u hoe u annotaties programmatisch kunt toevoegen en verwijderen om Word-documenten in Java op te maken.
Hieronder worden de volgende onderwerpen kort besproken:
- Java API voor Word DOC/DOCX-annotaties
- Annotaties toevoegen aan Word
- Annotaties uit Word-bestanden verwijderen
Java API om Word-bestanden te annoteren en te markeren
GroupDocs.Annotation levert de Java API om met de annotaties om te gaan. De API maakt het toevoegen, verwijderen en extraheren van annotaties uit Word-documenten en vele andere bestandsindelingen mogelijk. Ondersteunde documentformaten omvatten; spreadsheets, presentaties, afbeeldingen, PDF-bestanden, webpagina’s, e-mailberichten, Visio-tekeningen.
Downloaden of configureren
Download het JAR-bestand van de downloadsectie, of download gewoon de nieuwste repository- en afhankelijkheidsconfiguraties voor de pom.xml van uw maven-gebaseerde Java-applicaties.
<repository>
<id>GroupDocsJavaAPI</id>
<name>GroupDocs Java API</name>
<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>21.7.2</version>
</dependency>
Annotaties toevoegen aan Word in Java
Laten we verschillende soorten annotaties aan de Word-documenten toevoegen. Annotaties zijn er in vele soorten, dus we zullen er hier slechts een paar behandelen.
Voeg pijlannotatie toe aan Word in Java
Hieronder volgen de stappen om een pijlannotatie toe te voegen aan een Word-document in Java.
- Laad het document met behulp van de klasse Annotator.
- Initialiseer pijlannotatie met de klasse ArrowAnnotation.
- Pas de positie, het formaat en het paginanummer van de pijlannotatie aan.
- Voeg de gemaakte pijlannotatie toe met behulp van de add() methode.
- Sla het geannoteerde Word-document op in het pad met de juiste methode save().
Het volgende Java-codevoorbeeld laat zien hoe u een pijlaantekening toevoegt aan een Word-document.
// Pijlannotatie toevoegen aan Word-documenten in Java
final Annotator annotator = new Annotator("path/document.docx");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100));
arrow.setMessage("Arrow annotation");
arrow.setOpacity(0.7);
arrow.setPageNumber(0);
arrow.setPenColor(0x65535);
arrow.setPenStyle(PenStyle.Dot);
arrow.setPenWidth((byte) 3);
annotator.add(arrow);
annotator.save("path/annotatedDoc.docx");
Voeg rechthoek- of gebiedannotatie toe aan Word in Java
Hieronder volgen de stappen om rechthoek- of gebiedannotaties toe te voegen aan een DOC/DOCX-document met enkele aanpassingen. Het is vergelijkbaar met het toevoegen van Arrow-annotaties, maar het gebruikt AreaAnnotation.
- Laad het Word DOC/DOCX-document met de klasse Annotator.
- Initialiseer rechthoekige annotatie met de klasse AreaAnnotation.
- Pas de positie, grootte en kleur van de rechthoek aan.
- Stel andere eigenschappen in zoals paginanummer, achtergrond, dekking, stijl, penbreedte, berichten en tijd.
- Voeg de gemaakte rechthoekannotatie toe aan de annotator.
- Sla het geannoteerde Word-document op in het pad met behulp van de methode save().
Het volgende Java-codevoorbeeld laat zien hoe u rechthoek-/gebiedaantekeningen toevoegt aan een Word-document.
// Voeg gebieds- of rechthoekannotatie toe in Word-documenten in Java
final Annotator annotator = new Annotator("path/document.docx");
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);
annotator.add(area);
annotator.save("path/annotatedDoc.docx");
Ovale of ellipsvormige annotatie toevoegen aan Word in Java
Hieronder volgen de stappen om ovale/ellipsvormige annotaties toe te voegen aan een document in Java.
- Laad het DOC/DOCX-document met behulp van de klasse Annotator.
- Initialiseer ellipsannotatie met de klasse EllipseAnnotation.
- Stel de positie en grootte van de geïnitialiseerde ellipsannotatie in.
- Voeg de gemaakte ellipsannotatie toe aan de annotator.
- Sla het geannoteerde Word-bestand op met de juiste methode save().
Het volgende Java-codevoorbeeld laat zien hoe u ovale/ellipsvormige annotaties toevoegt aan elk Word-document.
// Ovale of ellipsvormige annotatie toevoegen in Word-documenten in Java
final Annotator annotator = new Annotator("path/document.docx");
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBackgroundColor(65535);
ellipse.setBox(new Rectangle(100, 100, 100, 100));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("This is ellipse annotation");
ellipse.setOpacity(0.7);
ellipse.setPageNumber(0);
ellipse.setPenColor(65535);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies);
annotator.add(ellipse);
annotator.save("path/annotatedDoc.docx");
Afstandsannotatie invoegen in Word in Java
Evenzo kunt u de afstand tussen twee punten vermelden met behulp van de afstandsannotatie. Hieronder volgen de stappen om afstandsannotaties toe te voegen aan het document in Java.
- Nadat u het Word-document hebt geladen, initialiseert u de annotatie op afstand met de klasse DistanceAnnotation.
- Stel het uiterlijk van de annotatie in.
- Voeg de annotatie voor de afstand toe aan het Annotator-object.
- Sla het geannoteerde document op de opgegeven locatie op of gebruik de juiste save()-methode,
Het volgende Java-codevoorbeeld laat zien hoe u afstandsaantekeningen toevoegt aan een DOC/DOCX-document.
// Annotatie op afstand toevoegen aan Word-documenten in Java
final Annotator annotator = new Annotator("path/document.docx");
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(200, 150, 200, 30));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is distance annotation");
distance.setOpacity(0.7);
distance.setPageNumber(0);
distance.setPenColor(65535);
distance.setPenStyle(PenStyle.Dot);
distance.setPenWidth((byte) 3);
distance.setReplies(replies);
annotator.add(distance);
annotator.save("path/annotatedDoc.docx");
Annotaties verwijderen uit Word DOC/DOCX-bestanden in Java
Er zijn veel manieren om annotaties uit Word-documenten te verwijderen. U kunt specifieke annotaties verwijderen door de indexen op te geven om de specifieke annotaties te verwijderen. Bovendien kunt u alle annotaties in één keer verwijderen. Details en Java-broncode voor het verwijderen van annotaties worden besproken in een apart artikel.
Hieronder volgen de stappen om alle annotaties uit een Word-bestand te verwijderen.
- Laad het document.
- Initialiseer opslagopties.
- Stel het annotatietype in op Geen.
- Sla het Word-bestand op. Het zal vrij zijn van annotaties.
De volgende code laat zien hoe u annotaties verwijdert uit een Word-bestand in Java.
// Verwijder alle annotaties uit het Word-document in Java
final Annotator annotator = new Annotator("path/annotatedDoc.docx");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);
Conclusie
Kortom, u hebt geleerd hoe u annotaties kunt toevoegen aan Word-documenten in Java-toepassingen. We hebben met name pijl-, ellips-, oppervlakte- en afstandsannotaties toegevoegd aan het Word DOC/DOCX-bestand met behulp van GroupDocs.Annotation for Java. Verder heb je ook gezien hoe je alle annotaties uit elk Word-bestand kunt verwijderen. Nu kunt u proberen uw eigen Java-toepassing voor documentannotatie te bouwen.
Lees meer over de API in de documentatie en de GitHub repository. Neem voor verdere vragen contact op met de ondersteuning op het forum.