Больше никаких долгих дискуссий в длинных ветках электронной почты о содержании документов. Вы можете использовать аннотации для разметки документов с персонализированными сообщениями и их ответами. В этой статье обсуждается, как программно аннотировать PDF-файлы для разметки документов с помощью C#. Кроме того, мы также обсудим, как удалить аннотации из файлов PDF.

Ниже кратко обсуждаются следующие темы:

.NET API для аннотирования PDF-файлов

GroupDocs.Annotation имеет свой .NET API для работы с аннотациями в документах и изображениях. Он позволяет добавлять, удалять и извлекать аннотации из документов PDF и Word, электронных таблиц и презентаций. Кроме того, он поддерживает изображения, веб-страницы, сообщения электронной почты, рисунки Visio и многое другое. Полный список [поддерживаемых форматов документов для аннотаций] можно посмотреть в документации (https://docs.groupdocs.com/annotation/net/supported-document-formats/).

Загрузите его DLL или MSI установщик из раздела загрузок или установите API в свое приложение .NET через NuGet. Вы также можете использовать следующую команду из диспетчера пакетов.

PM> Install-Package GroupDocs.Annotation

Добавить аннотации в PDF с помощью C#

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

Добавлены аннотации в PDF

Ниже приведены некоторые из поддерживаемых аннотаций. Вы можете узнать о каждой аннотации отдельно.

Добавить аннотацию со стрелкой в PDF с помощью C#

Ниже приведены шаги по добавлению аннотаций со стрелками в документы PDF на C#.

Программное добавление аннотаций со стрелками в Java и C# .NET
  • Загрузите документ PDF с помощью класса Annotator.
  • Инициализируйте Аннотацию со стрелкой.
  • Определите положение, размер, номер страницы аннотации стрелки.
  • Добавьте определенную аннотацию со стрелкой, используя метод Добавить.
  • Сохраните аннотированный документ с помощью соответствующего метода Save().

В следующем примере кода C# показано, как добавить аннотацию со стрелкой в документ PDF.

// Добавить аннотацию со стрелкой в документы PDF с помощью C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    ArrowAnnotation arrow = new ArrowAnnotation
    {
        Box = new Rectangle(100, 100, 50, 50),

        // по желанию --
        CreatedOn = DateTime.Now,
        Message = "Your Message",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -3407872,
        PenStyle = PenStyle.Solid,
        PenWidth = 2
    };
    annotator.Add(arrow);
    annotator.Save("path/annotation.pdf");
}

Вставьте аннотацию прямоугольника или области в PDF с помощью C#

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

  • Загрузите документ PDF с помощью класса Annotator.
  • Инициализировать прямоугольную аннотацию с помощью класса AreaAnnotation.
  • Укажите положение, размер и цвет прямоугольника.
  • Вы также можете установить другие свойства, такие как номер страницы, фон, непрозрачность, стиль, толщина пера, сообщения и время.
  • Добавьте аннотацию определенного прямоугольника в Annotator.
  • Наконец, сохраните аннотированный файл с помощью метода Save().
Программное добавление аннотации прямоугольника или области в C# .NET и Java

В следующем примере кода аннотация прямоугольника или области добавляется в документ PDF с помощью C#.

// Добавление аннотации области или прямоугольника в документы PDF с помощью C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    AreaAnnotation area = new AreaAnnotation
    {
        BackgroundColor = 65535,
        Box = new Rectangle(80, 75, 450, 135),
        Message = "This is area annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -131,
        PenStyle = PenStyle.Dash,
        PenWidth = 3
    };
    annotator.Add(area);
    annotator.Save("path/annotation.pdf");
}

Добавьте аннотацию овала или эллипса в PDF с помощью C#

Точно так же давайте добавим аннотацию в виде эллипса/овала. Следующие шаги показывают, как можно добавить аннотацию в виде овала или эллипса в файл PDF с помощью C#.

Добавление эллипсов или овальных аннотаций программно в C# .NET и Java
  • Загрузите файл PDF с помощью класса Аннотатор.
  • Инициализируйте Аннотацию эллипса.
  • Установите положение, размер и другие свойства инициализированной аннотации.
  • Добавьте созданную аннотацию в виде эллипса к объекту Annotator.
  • Используйте метод Сохранить(), чтобы сохранить файл PDF с комментариями.

В следующем примере кода C# в документ PDF добавляется овальная или эллипсная аннотация.

// Добавьте аннотацию овала или эллипса в документы PDF с помощью C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    EllipseAnnotation ellipse = new EllipseAnnotation
    {
        BackgroundColor = -16034924,
        Box = new Rectangle(275, 475, 300, 80),
        Message = "This is ellipse annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -16034924,
        PenStyle = PenStyle.Dot,
        PenWidth = 3
    };
    annotator.Add(ellipse);
    annotator.Save("path/annotation.pdf");
}

Вставьте аннотацию расстояния в PDF с помощью С#

Вы можете использовать аннотацию расстояния, чтобы указать расстояние между двумя объектами. Ниже приведены шаги, которые добавляют аннотацию расстояния в документ PDF с помощью C#.

Программное добавление аннотации расстояния в C# .NET и Java
  • После загрузки документа PDF с помощью класса Annotator инициализируйте аннотацию расстояния с помощью [DistanceAnnotation](https://apireference.groupdocs. com/annotation/net/groupdocs.annotation.models.annotationmodels/distanceannotation).
  • Установите внешний вид, цвет линии, толщину, стиль и т. д.
  • Добавьте аннотацию расстояния в Annotator.
  • Сохраните файл PDF с аннотацией, используя соответствующий метод Сохранить().

В следующем фрагменте кода показано, как добавить аннотацию расстояния в PDF-файл с помощью C#.

// Добавление аннотации Distance к документам PDF с помощью C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    DistanceAnnotation distance = new DistanceAnnotation
    {
        Box = new Rectangle(750, 235, 0, 150),
        Message = "This is the heading area",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -21197,
        PenStyle = PenStyle.Solid,
        PenWidth = 3
    };
    annotator.Add(distance);
    annotator.Save("path/annotation.pdf");
}

Удалить аннотации из PDF-файлов с помощью C#

Существуют различные способы удаления аннотаций из PDF-документов. Либо вы можете удалить все аннотации сразу, либо вы можете предоставить идентификаторы, индексы для удаления выборочных. Мы обсуждали различные способы удаления аннотаций в отдельной статье. Однако вот шаги по удалению всех аннотаций из файла PDF.

  • Загрузите документ.
  • Инициализируйте Параметры сохранения.
  • Установите типы аннотаций на Нет.
  • Сохраните файл PDF без аннотаций, используя метод Save().

В следующем коде C# показано, как удалить аннотации из файлов PDF.

// Удалите все аннотации из документа PDF с помощью С#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
    annotator.Save("path/document-noAnnotation.pdf", new SaveOptions {AnnotationTypes = AnnotationType.None});
}

Вывод

В заключение вы узнали, как добавлять различные аннотации к документам PDF в приложениях .NET с помощью C#. Точнее, мы добавили аннотации стрелки, эллипса, области и расстояния. Кроме того, вы также видели один из способов удаления всех аннотаций из любого файла PDF.

Вы можете подумать о создании собственного приложения .NET для комментирования документов. Чтобы узнать больше о GroupDocs.Annotation для .NET, посетите документацию и [GitHub](https://github.com/ репозиторий groupdocs-annotation). По дополнительным вопросам обращайтесь в службу поддержки на форуме.

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