Аннотации обычно используются для упоминания ошибок в документах или для обсуждения их содержания. С помощью аннотаций вы можете избежать долгих и бесконечных дискуссий в цепочках электронных писем. В этой статье вы узнаете, как программно добавлять и удалять аннотации для разметки документов Word на Java.

Ниже приведены темы, кратко обсуждаемые ниже:

Java API для аннотирования и разметки файлов Word

GroupDocs.Annotation предоставляет API Java для работы с аннотациями. API позволяет добавлять, удалять и извлекать аннотации из документов Word и многих других форматов файлов. Поддерживаемые форматы документов включают; электронные таблицы, презентации, изображения, файлы PDF, веб-страницы, сообщения электронной почты, рисунки Visio.

Загрузите или настройте

Загрузите файл JAR из раздела загрузок или просто получите последний репозиторий и конфигурации зависимостей для pox.xml вашего *на основе maven * 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>

Добавить аннотации в Word на Java

Давайте добавим различные типы аннотаций к документам Word. Аннотации бывают разных типов, поэтому здесь мы рассмотрим лишь некоторые из них.

Добавьте аннотации в DOC DOCX с помощью API GroupDocs

Добавить аннотацию со стрелкой в 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");
Добавление аннотации стрелки программно в Java и .NET

Вставьте аннотацию прямоугольника или области в Word в Java

Ниже приведены шаги по добавлению аннотации прямоугольника или области к документу DOC/DOCX с некоторыми настройками. Это похоже на добавление аннотаций Arrow, но использует AreaAnnotation.

  • Загрузите документ Word DOC/DOCX с помощью класса Annotator.
  • Инициализировать прямоугольную аннотацию с помощью класса AreaAnnotation.
  • Отрегулируйте положение, размер и цвет прямоугольника.
  • Установите другие свойства, такие как номер страницы, фон, непрозрачность, стиль, толщина пера, сообщения и время.
  • Добавьте аннотацию созданного прямоугольника в Annotator.
  • Сохраните аннотированный документ 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");
Программное добавление аннотации прямоугольника или области в .NET и Java

Добавить аннотацию овала или эллипса в Word на Java

Ниже приведены шаги для добавления аннотации овала/эллипса к документу на Java.

  • Загрузите документ DOC/DOCX с помощью класса Annotator.
  • Инициализировать аннотацию эллипса с помощью класса EllipseAnnotation.
  • Установите положение и размер инициализированной аннотации эллипса.
  • Добавьте созданную аннотацию в виде эллипса в Annotator.
  • Сохраните аннотированный файл 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");
Добавление эллипсов или овальных аннотаций программно в C# .NET и Java

Вставить аннотацию расстояния в Word в Java

Точно так же вы можете указать расстояние между двумя точками, используя аннотацию расстояния. Ниже приведены шаги для добавления аннотации расстояния в документ на Java.

  • После загрузки документа Word инициализируйте аннотацию расстояния с помощью класса DistanceAnnotation.
  • Установить внешний вид аннотации.
  • Добавьте аннотацию расстояния к объекту Annotator.
  • Сохраните аннотированный документ в указанном месте или используйте правильный метод save(),

В следующем примере кода Java показано, как добавить аннотацию расстояния в документ DOC/DOCX.

// Добавить аннотацию Distance к документам 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");
Программное добавление аннотации расстояния в C# .NET и Java

Удалить аннотации из файлов Word DOC/DOCX в Java

Есть много способов удалить аннотации из документов Word. Вы можете удалить определенные аннотации, предоставив индексы для удаления определенных аннотаций. Кроме того, вы можете удалить все аннотации сразу. Подробности и исходный код Java для удаления аннотаций обсуждаются в отдельной статье.

Ниже приведены шаги по удалению всех аннотаций из файла 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. По дополнительным вопросам обращайтесь в службу поддержки на форуме.

Смотрите также