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 adnotacje do DOC DOCX za pomocą GroupDocs API

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");
Programowe dodawanie adnotacji strzałek w językach Java i .NET

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");
Programowe dodawanie adnotacji prostokąta lub obszaru w .NET i Javie

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");
Programowe dodawanie elips lub adnotacji owalnych w językach C# .NET i Java

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");
Programowe dodawanie adnotacji odległości w językach C# .NET i Java

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.

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.

Zobacz też