Adnotacje są zwykle używane do wymieniania błędów w dokumentach lub do omawiania ich treści. Dzięki adnotacjom możesz uniknąć długich i niekończących się dyskusji w wątkach e-maili. W tym artykule dowiesz się, jak programowo dodawać i usuwać adnotacje do znaczników dokumentów Word w Javie.
Oto tematy omówione pokrótce poniżej:
Java API do adnotacji i oznaczania plików Word
GroupDocs.Annotation zapewnia interfejs Java API do obsługi adnotacji. Interfejs API umożliwia dodawanie, usuwanie i wyodrębnianie adnotacji z dokumentów programu Word i wielu innych formatów plików. Obsługiwane formaty dokumentów obejmują; arkusze kalkulacyjne, prezentacje, obrazy, pliki PDF, strony internetowe, wiadomości e-mail, rysunki programu Visio.
Pobierz lub skonfiguruj
Pobierz plik JAR z sekcji pobierania lub po prostu pobierz najnowsze konfiguracje repozytorium i zależności dla pliku pom.xml aplikacji Java opartych na Maven.
<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>
Dodaj adnotacje do programu Word w Javie
Dodajmy różne typy adnotacji do dokumentów programu Word. Istnieje wiele rodzajów adnotacji, dlatego omówimy tutaj tylko kilka z nich.
Dodaj adnotację strzałki do programu Word w Javie
Poniżej przedstawiono kroki, aby dodać adnotację strzałki do dokumentu Word w Javie.
- Załaduj dokument za pomocą klasy Annotator.
- Zainicjuj adnotację strzałki za pomocą klasy ArrowAnnotation.
- Dostosuj położenie, rozmiar, numer strony adnotacji strzałki.
- Dodaj utworzoną adnotację strzałki za pomocą metody add().
- Zapisz dokument programu Word z adnotacjami w ścieżce, używając odpowiedniej metody save().
Poniższy przykładowy kod Java pokazuje, jak dodać adnotację strzałki do dokumentu programu Word.
// Dodaj adnotację strzałki do dokumentów programu Word w Javie
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");
Wstaw adnotację prostokąta lub obszaru do programu Word w Javie
Poniżej przedstawiono kroki dodawania adnotacji prostokąta lub obszaru do dokumentu DOC/DOCX z pewnymi dostosowaniami. Jest to podobne do dodawania adnotacji Arrow, ale używa funkcji AreaAnnotation.
- Załaduj dokument Word DOC/DOCX za pomocą klasy Annotator.
- Zainicjuj adnotację prostokąta przy użyciu klasy AreaAnnotation.
- Dostosuj położenie, rozmiar i kolor prostokąta.
- Ustaw inne właściwości, takie jak numer strony, tło, krycie, styl, szerokość pióra, komunikaty i czas.
- Dodaj utworzoną adnotację prostokąta do adnotatora.
- Zapisz dokument programu Word z adnotacjami w ścieżce za pomocą metody save().
Poniższy przykładowy kod Java pokazuje, jak dodać adnotację prostokąta/obszaru do dokumentu programu Word.
// Dodaj adnotację obszaru lub prostokąta w dokumentach programu Word w Javie
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");
Dodaj adnotację owalną lub elipsę do programu Word w Javie
Poniżej przedstawiono kroki dodawania adnotacji owalnych/elipsy do dokumentu w Javie.
- Załaduj dokument DOC/DOCX za pomocą klasy Annotator.
- Zainicjuj adnotację elipsy przy użyciu klasy EllipseAnnotation.
- Ustaw pozycję i rozmiar zainicjowanej adnotacji wielokropka.
- Dodaj utworzoną adnotację elipsy do adnotatora.
- Zapisz plik programu Word z adnotacjami, używając odpowiedniej metody save().
Poniższy przykładowy kod Java pokazuje, jak dodać adnotację owalną/elipsy do dowolnego dokumentu programu Word.
// Dodaj adnotację owalną lub elipsę w dokumentach programu Word w Javie
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");
Wstaw adnotację odległości do programu Word w Javie
Podobnie możesz podać odległość między dwoma punktami za pomocą adnotacji odległości. Poniżej przedstawiono kroki dodawania adnotacji odległości do dokumentu w Javie.
- Po załadowaniu dokumentu Word zainicjuj adnotację odległości przy użyciu klasy DistanceAnnotation.
- Ustaw wygląd adnotacji.
- Dodaj adnotację odległości do obiektu Adnotator.
- Zapisz dokument z adnotacjami w podanej lokalizacji lub użyj odpowiedniej metody save(),
Poniższy przykładowy kod Java pokazuje, jak dodać adnotację odległości do dokumentu DOC/DOCX.
// Dodaj adnotację odległości do dokumentów programu Word w Javie
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");
Usuń adnotacje z plików Word DOC/DOCX w Javie
Istnieje wiele sposobów usuwania adnotacji z dokumentów programu Word. Możesz usunąć określone adnotacje, udostępniając indeksy, aby usunąć określone adnotacje. Dodatkowo możesz usunąć wszystkie adnotacje naraz. Szczegóły i kod źródłowy Java do usuwania adnotacji omówiono w osobnym artykule.
Poniżej przedstawiono kroki, aby usunąć wszystkie adnotacje z pliku Word.
- Załaduj dokument.
- Zainicjuj opcje zapisywania.
- Ustaw typ adnotacji na Brak.
- Zapisz plik Worda. Będzie wolny od adnotacji.
Poniższy kod pokazuje, jak usunąć adnotacje z pliku Word w Javie.
// Usuń wszystkie adnotacje z dokumentu programu Word w Javie
final Annotator annotator = new Annotator("path/annotatedDoc.docx");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);
Wniosek
Podsumowując, nauczyłeś się dodawać adnotacje do dokumentów Worda w aplikacjach Java. W szczególności dodaliśmy adnotacje strzałek, elips, obszarów i odległości do pliku Word DOC/DOCX za pomocą GroupDocs.Annotation for Java. Ponadto widziałeś również, jak usunąć wszystkie adnotacje z dowolnego pliku Word. Teraz możesz spróbować zbudować własną aplikację Java do adnotacji dokumentów.
Dowiedz się więcej o interfejsie API z repozytorium documentation i GitHub. W przypadku dalszych pytań skontaktuj się z pomocą techniczną na forum.