Анотації зазвичай використовуються для згадування помилок у документах або для обговорення їх змісту. За допомогою анотацій ви можете уникнути довгих і нескінченних обговорень у гілках електронних листів. У цій статті ви дізнаєтесь, як програмно додавати та видаляти анотації до розмітки документів Word у Java.
Нижче наведено теми, які коротко обговорюються:
Java API для анотування та розмітки файлів Word
GroupDocs.Annotation надає Java API для роботи з анотаціями. API дозволяє додавати, видаляти та видобувати анотації з документів Word і багатьох інших форматів файлів. Підтримувані формати документів включають; електронні таблиці, презентації, зображення, файли PDF, веб-сторінки, повідомлення електронної пошти, малюнки Visio.
Завантажити або налаштувати
Завантажте файл JAR із розділу завантажень або просто отримайте найновіші конфігурації сховища та залежностей для pom.xml ваших програм Java на основі 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>
Додайте анотації до Word у Java
Давайте додамо різні типи анотацій до документів Word. Існує багато типів анотацій, тому ми розглянемо лише деякі з них.

Додайте анотацію зі стрілкою до Word у Java
Нижче наведено кроки, щоб додати анотацію зі стрілкою до документа Word у Java.
- Завантажте документ за допомогою класу Annotator.
- Ініціалізуйте анотацію стрілки за допомогою класу ArrowAnnotation.
- Налаштуйте положення, розмір, номер сторінки анотації зі стрілкою.
- Додайте створену анотацію стрілки за допомогою методу add().
- Збережіть анотований документ Word у шлях за допомогою відповідного методу save().
У наведеному нижче прикладі коду Java показано, як додати анотацію зі стрілкою до документа Word.
// Додайте анотацію зі стрілкою до документів Word у 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");

Вставте анотацію прямокутника або області до Word у Java
Нижче наведено кроки для додавання анотації прямокутника або області до документа DOC/DOCX із деякими налаштуваннями. Це схоже на додавання анотацій зі стрілками, але використовує AreaAnnotation.
- Завантажте документ Word DOC/DOCX за допомогою класу Annotator.
- Ініціалізуйте анотацію прямокутника за допомогою класу AreaAnnotation.
- Налаштуйте положення, розмір і колір прямокутника.
- Встановіть інші властивості, наприклад номер сторінки, фон, непрозорість, стиль, ширину пера, повідомлення та час.
- Додайте створену прямокутну анотацію до Анотатора.
- Збережіть анотований документ Word у шлях за допомогою методу save().
У наведеному нижче прикладі коду Java показано, як додати анотацію прямокутника/області до документа Word.
// Додайте анотацію області або прямокутника в документи Word на 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");

Додайте овальну або еліпсову анотацію до Word у Java
Нижче наведено кроки для додавання овальної/еліптичної анотації до документа в Java.
- Завантажте документ DOC/DOCX за допомогою класу Annotator.
- Ініціалізуйте анотацію еліпса за допомогою класу EllipseAnnotation.
- Встановіть положення та розмір ініціалізованої анотації еліпса.
- Додайте створену анотацію еліпса до анотатора.
- Збережіть анотований файл Word за допомогою відповідного методу save().
У наведеному нижче прикладі коду Java показано, як додати анотацію овал/еліпс до будь-якого документа Word.
// Додайте овальну або еліпсову анотацію в документи Word у 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");

Вставте анотацію відстані до Word у Java
Так само ви можете згадати відстань між двома точками за допомогою анотації відстані. Нижче наведено кроки для додавання анотації відстані до документа на Java.
- Після завантаження документа Word ініціалізуйте анотацію відстані за допомогою класу DistanceAnnotation.
- Налаштувати зовнішній вигляд анотації.
- Додайте анотацію відстані до об’єкта Annotator.
- Збережіть анотований документ у вказаному місці або скористайтеся правильним методом save(),
У наведеному нижче прикладі коду Java показано, як додати анотацію відстані до документа DOC/DOCX.
// Додайте анотацію «Відстань» до документів Word у 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");

Видаліть анотації з файлів Word DOC/DOCX у Java
Існує багато способів видалити анотації з документів Word. Ви можете видалити певні анотації, надавши індекси для видалення конкретних анотацій. Крім того, ви можете видалити всі анотації одночасно. Деталі та вихідний код Java для видалення анотацій обговорюються в окремій статті.
Нижче наведено кроки, щоб видалити всі анотації з файлу Word.
- Завантажте документ.
- Ініціалізувати параметри збереження.
- Установіть для типу анотації значення «Немає».
- Збережіть файл Word. Він буде вільним від анотацій.
Наступний код показує, як видалити анотації з файлу Word у Java.
// Видаліть усі анотації з документа Word у Java
final Annotator annotator = new Annotator("path/annotatedDoc.docx");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);
Висновок
Підсумовуючи, ви дізналися, як додавати анотації до документів Word у програмах Java. Зокрема, ми додали анотації стрілок, еліпса, площі та відстані до файлу Word DOC/DOCX за допомогою GroupDocs.Annotation for Java. Крім того, ви також бачили, як видалити всі анотації з будь-якого файлу Word. Тепер ви можете спробувати створити власну програму Java для анотаторів документів.
Дізнайтеся більше про API в документації і репозиторії GitHub. Щоб отримати додаткові запитання, зверніться до служби підтримки на форумі.