Le annotazioni vengono normalmente utilizzate per menzionare errori nei documenti o per discuterne il contenuto. Con le annotazioni, puoi evitare discussioni lunghe e senza fine all’interno dei thread di posta elettronica. In questo articolo imparerai come aggiungere e rimuovere a livello di codice le annotazioni per contrassegnare i documenti di Word in Java.
Di seguito gli argomenti brevemente discussi:
- API Java per annotazioni Word DOC/DOCX
- Aggiungi annotazioni a Word
- Rimuovi annotazioni dai file di Word
API Java per annotare e annotare file di Word
GroupDocs.Annotation fornisce l’API Java per gestire le annotazioni. L’API consente l’aggiunta, la rimozione e l’estrazione di annotazioni da documenti Word e molti altri formati di file. Formati di documento supportati includono; fogli di calcolo, presentazioni, immagini, file PDF, pagine Web, messaggi di posta elettronica, disegni di Visio.
Scarica o configura
Scarica il file JAR dalla sezione download, o ottieni semplicemente l’ultimo repository e le configurazioni delle dipendenze per pom.xml del tuo *maven-based * Applicazioni Java.
<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>
Aggiungi annotazioni a Word in Java
Aggiungiamo diversi tipi di annotazioni ai documenti di Word. Le annotazioni sono di molti tipi, quindi qui ne tratteremo solo alcune.
Aggiungi annotazione freccia a Word in Java
Di seguito sono riportati i passaggi per aggiungere un’annotazione freccia a un documento Word in Java.
- Carica il documento utilizzando la classe Annotator.
- Inizializza l’annotazione della freccia con la classe ArrowAnnotation.
- Regola la posizione, la dimensione, il numero di pagina dell’annotazione della freccia.
- Aggiungi l’annotazione della freccia creata usando il metodo add().
- Salva il documento Word annotato nel percorso utilizzando il metodo save() appropriato.
L’esempio di codice Java seguente mostra come aggiungere un’annotazione con una freccia a un documento di Word.
// Aggiungi l'annotazione Freccia ai documenti di Word 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");
Inserisci annotazione rettangolo o area in Word in Java
Di seguito sono riportati i passaggi per aggiungere annotazioni a rettangolo o area a un documento DOC/DOCX con alcune personalizzazioni. È simile all’aggiunta di annotazioni Arrow ma utilizza AreaAnnotation.
- Carica il documento Word DOC/DOCX utilizzando la classe Annotator.
- Inizializza l’annotazione del rettangolo utilizzando la classe AreaAnnotation.
- Regola la posizione, le dimensioni e il colore del rettangolo.
- Imposta altre proprietà come numero di pagina, sfondo, opacità, stile, larghezza penna, messaggi e ora.
- Aggiungi l’annotazione rettangolo creata all’Annotator.
- Salva il documento Word annotato nel percorso usando il metodo save().
L’esempio di codice Java seguente mostra come aggiungere annotazioni rettangolo/area a un documento di Word.
// Aggiungi annotazione area o rettangolo nei documenti Word 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");
Aggiungi annotazione ovale o ellisse a Word in Java
Di seguito sono riportati i passaggi per aggiungere un’annotazione ovale/ellisse a un documento in Java.
- Carica il documento DOC/DOCX utilizzando la classe Annotator.
- Inizializza l’annotazione dell’ellisse utilizzando la classe EllipseAnnotation.
- Impostare la posizione e la dimensione dell’annotazione dell’ellisse inizializzata.
- Aggiungi l’annotazione dell’ellisse creata all’Annotator.
- Salva il file Word annotato utilizzando il metodo save() appropriato.
L’esempio di codice Java seguente mostra come aggiungere un’annotazione ovale/ellisse a qualsiasi documento di Word.
// Aggiungi annotazioni ovali o ellittiche nei documenti Word 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");
Inserisci l’annotazione della distanza in Word in Java
Allo stesso modo, puoi menzionare la distanza tra due punti usando l’annotazione della distanza. Di seguito sono riportati i passaggi per aggiungere l’annotazione della distanza al documento in Java.
- Dopo aver caricato il documento di Word, inizializzare l’annotazione della distanza utilizzando la classe DistanceAnnotation.
- Imposta l’aspetto dell’annotazione.
- Aggiungi l’annotazione della distanza all’oggetto Annotatore.
- Salva il documento annotato nella posizione indicata o usa il metodo save() corretto,
L’esempio di codice Java seguente mostra come aggiungere un’annotazione della distanza a un documento DOC/DOCX.
// Aggiungi l'annotazione della distanza ai documenti di Word 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");
Rimuovere le annotazioni dai file Word DOC/DOCX in Java
Esistono molti modi per rimuovere le annotazioni dai documenti di Word. Puoi rimuovere annotazioni specifiche fornendo gli indici per rimuovere le annotazioni specifiche. Inoltre, puoi rimuovere tutte le annotazioni contemporaneamente. I dettagli e il codice sorgente Java per la rimozione delle annotazioni sono discussi in un articolo separato.
Di seguito sono riportati i passaggi per rimuovere tutte le annotazioni da un file di Word.
- Carica il documento.
- Inizializza opzioni di salvataggio.
- Impostare il tipo di annotazione su Nessuno.
- Salva il file di Word. Sarà privo di annotazioni.
Il codice seguente mostra come rimuovere le annotazioni da un file Word in Java.
// Rimuovere tutte le annotazioni dal documento Word in Java
final Annotator annotator = new Annotator("path/annotatedDoc.docx");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);
Conclusione
Per riassumere, hai imparato come aggiungere annotazioni ai documenti Word all’interno delle applicazioni Java. In particolare, abbiamo aggiunto annotazioni a freccia, ellisse, area e distanza al file Word DOC/DOCX utilizzando GroupDocs.Annotation for Java. Inoltre, hai anche visto come rimuovere tutte le annotazioni da qualsiasi file di Word. Ora puoi provare a creare la tua applicazione Java per annotatore di documenti.
Scopri di più sull’API dalla documentazione e dal repository GitHub. Per ulteriori domande, contatta il supporto sul forum.