Komentarze są używane w dokumentach Word, DOCX lub DOC, do sugerowania ulepszeń i modyfikacji. Przyjrzyjmy się, jak wstawiać komentarze, a także usuwać lub usuwać komentarze programowo przy użyciu języka Java. Możesz dodać nazwisko autora, inicjały, tekst komentarza, datę i godzinę w zależności od wymagań. Wszystkie te zadania będziemy wykonywać za pomocą API Aspose.Words for Java.
Tutaj nauczymy się następujących przypadków użycia związanych z komentarzami w dokumentach Word:
- Wstaw komentarz w istniejącym dokumencie programu Word przy użyciu języka Java
- Wstaw komentarz w nowym dokumencie programu Word przy użyciu języka Java
- Usuń określone komentarze z dokumentu programu Word za pomocą języka Java
- Usuń wszystkie komentarze z dokumentów programu Word za pomocą języka Java
Wstaw lub usuń komentarze w plikach Word (DOCX/DOC) API – Instalacja
Najnowszą wersję Aspose.Words for Java API można pobrać z sekcji Downloads lub z repozytorium Maven, zgodnie z poniższymi konfiguracjami:
Magazyn:
<repositories>
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
</repositories>
Zależność:
<dependencies>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-words</artifactId>
<version>20.6</version>
<classifier>jdk17</classifier>
</dependency>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-words</artifactId>
<version>20.7</version>
<classifier>javadoc</classifier>
</dependency>
</dependencies>
Tak więc interfejs API został już skonfigurowany i możemy przystąpić do eksploracji różnych przypadków użycia pracy z komentarzami w dokumentach programu Word.
Wstaw komentarz w istniejącym dokumencie programu Word przy użyciu języka Java
Możesz wstawiać lub dodawać komentarze do istniejących plików Microsoft Word, DOCX lub DOC, za pomocą Aspose.Words for Java API. Może to być pomocne podczas przeglądania dokumentów, na przykład przełożony może zasugerować kilka zmian lub ulepszeń w raporcie wykonalności. Ponadto każdy, kto ma uprawnienia do edycji dokumentu Word, może pracować z komentarzami. Musisz wykonać poniższe kroki, aby wstawić komentarze w pliku Word (DOCX/DOC):
- Załaduj istniejący plik DOCX z klasą Document
- Utwórz komentarz
- Zapisz plik DOCX
Poniższy fragment kodu pokazuje, jak wstawić komentarz w dokumencie programu Word przy użyciu języka Java:
// Załaduj źródłowy dokument tekstowy
Document doc = new Document(dataDir + "Comments.docx");
// Zainicjuj obiekt DocumentBuilder
DocumentBuilder builder = new DocumentBuilder(doc);
// Utwórz nowy komentarz
Comment comment = new Comment(doc, "Aspose", "Initials", new java.util.Date());
builder.getCurrentParagraph().appendChild(comment);
comment.getParagraphs().add(new com.aspose.words.Paragraph(doc));
comment.getFirstParagraph().getRuns().add(new com.aspose.words.Run(doc, "Sample Comment"));
// Zapisz plik wyjściowy
doc.save(dataDir + "Comments_Output.docx");
Poniższy zrzut ekranu przedstawia przykładowy komentarz dodany w istniejących dokumentach programu Word:
![Wstaw komentarz w wordzie](images/CommentExisting-1024x535.png#center)
Wstaw komentarz w nowym dokumencie programu Word przy użyciu języka Java
Komentarze są również pomocne podczas tworzenia nowego dokumentu Word. Na przykład niektóre teksty mogą wymagać dopracowania, które można wyjaśnić za pomocą komentarza. Podobnie mogą istnieć setki przypadków użycia, w których komentarze mogą pomóc podczas tworzenia nowego pliku DOCX. Możesz łatwo dodawać lub wstawiać komentarze, wykonując poniższe czynności:
- Zainicjuj obiekt DocumentBuilder
- Dodaj przykładowy tekst
- Utwórz niestandardowy komentarz
- Zapisz plik DOCX
Poniższy fragment kodu pokazuje, jak wstawiać komentarze podczas tworzenia od podstaw nowego dokumentu tekstowego przy użyciu języka Java:
// Zainicjuj nowy dokument Word
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Dodaj tekst
builder.write("Some text is added.");
// Utwórz nowy komentarz
Comment comment = new Comment(doc, "Aspose", "Initials", new java.util.Date());
builder.getCurrentParagraph().appendChild(comment);
comment.getParagraphs().add(new com.aspose.words.Paragraph(doc));
comment.getFirstParagraph().getRuns().add(new com.aspose.words.Run(doc, "Sample Comment"));
// Zapisz wyjściowy plik DOCX
doc.save(dataDir + "Comments_Output.docx");
Poniższy zrzut ekranu pokazuje dane wyjściowe, w których komentarz jest dodawany do nowego dokumentu tekstowego:
![usuń komentarz w wordzie](images/CommentsNew-1024x415.png#center)
Usuń określone komentarze z dokumentu programu Word za pomocą języka Java
Komentarze są często usuwane, gdy sugerowane ulepszenia lub modyfikacje są wprowadzane do dokumentu Word. Jeśli chcesz usunąć określone komentarze, możesz wykonać poniższe czynności:
- Załaduj źródłowy dokument tekstowy
- Podaj nazwisko autora
- Usuń komentarze określonego autora
Poniższy fragment kodu pokazuje, jak usunąć określone komentarze z pliku Word za pomocą Javy:
// Otwórz dokument.
Document doc = new Document(dataDir + "Comments.docx");
String authorName = "Aspose";
// Zbierz wszystkie komentarze w dokumencie
NodeCollection comments = doc.getChildNodes(NodeType.COMMENT, true);
// Przejrzyj wszystkie komentarze i usuń te napisane przez autora Aspose.
for (int i = comments.getCount() - 1; i >= 0; i--) {
Comment comment = (Comment) comments.get(i);
if (comment.getAuthor().equals(authorName))
comment.remove();
}
// Zapisz wyjściowy plik DOCX
doc.save(dataDir + "output.docx");
Usuń wszystkie komentarze z dokumentów programu Word za pomocą języka Java
Wszystkie komentarze dokumentu Word można usunąć jednocześnie. Możesz wykonać poniższe czynności, aby usunąć wszystkie komentarze:
- Otwórz plik word docx
- Zbierz wszystkie komentarze w pliku
- Usuń wszystkie komentarze
Poniższy fragment kodu wyjaśnia, jak usunąć wszystkie komentarze z dokumentów programu Word za pomocą języka Java:
// Otwórz dokument.
Document doc = new Document(dataDir + "Comments.docx");
// Zbierz wszystkie komentarze w dokumencie
NodeCollection comments = doc.getChildNodes(com.aspose.words.NodeType.COMMENT, true);
// Usuń wszystkie komentarze.
comments.clear();
doc.save(dataDir + "output.docx");
Wniosek
Podsumowując, nauczyliśmy się, jak programowo dodawać, wstawiać, usuwać lub usuwać komentarze z dokumentów Word za pomocą Javy. Jeśli masz jakiekolwiek wątpliwości lub niejasności, skontaktuj się z nami na Free Support Forum.