Додавання або видалення анотацій або файлів розмітки Word за допомогою C#

Забудьте про обговорення вмісту документів і відгуків у довгих електронних листах. Просто використовуйте анотації для розмітки документів із повідомленнями та відповідями. У цій статті ви дізнаєтесь, як програмно додавати та видаляти анотації для розмітки документів Word на C# за допомогою програм .NET.

Нижче наведено теми, які коротко обговорюються:

.NET API для анотацій Word DOC/DOCX
Додайте анотації до Word
Видаліть анотації з файлів Word

.NET API для анотування та розмітки файлів Word

GroupDocs.Annotation надає .NET API для роботи з анотаціями для ваших документів і зображень у ваших програмах .NET. API дозволяє додавати, видаляти та витягувати анотації з документів Word. Крім того, він підтримує електронні таблиці, презентації, зображення, файли PDF, веб-сторінки, повідомлення електронної пошти, малюнки Visio. Деякі креслення AutoCAD і формати цифрових зображень, такі як DICOM, також є в списку. Щоб отримати повний список підтримуваних форматів документів для анотацій, відвідайте документацію.

Завантажте інсталятор DLL або MSI із розділу завантажень або інсталюйте API у своїй програмі .NET за допомогою NuGet. Ви також можете використати наступну команду з менеджера пакетів.

PM> Install-Package GroupDocs.Annotation

Додайте анотації до Word у C#

Давайте додамо кілька різних типів анотацій до документів Word. Існує багато різних типів анотацій, тому в цій статті ми розглянемо лише деякі.

Додайте анотації до DOC DOCX за допомогою GroupDocs API

Існує кілька підтримуваних типів анотацій, ви можете дізнатися про кожну анотацію окремо.

Анотація площі / прямокутника
Стрілка
Підкреслити
Водяний знак
Відстань
Викреслити
Текстове поле
Еліпс
Виділіть
Посилання
точка
Ломана лінія
Заміна
Редакція ресурсу
Редакція тексту

Додайте анотацію зі стрілкою до Word за допомогою C#

Нижче наведено кроки, щоб додати анотацію зі стрілками до документа Word у C#.

Програмно додайте анотацію зі стрілкою в Java та .NET

Завантажте документ за допомогою класу Annotator.
Ініціалізуйте анотацію стрілки за допомогою класу ArrowAnnotation.
Налаштуйте положення, розмір, номер сторінки анотації зі стрілкою.
Додайте створену анотацію стрілки за допомогою методу Add.
Збережіть анотований документ Word у шлях за допомогою методу Save.

У наведеному нижче прикладі коду показано, як додати анотацію зі стрілкою до документа Word за допомогою C#.

// Додайте анотацію зі стрілкою до документів Word за допомогою C#
using (Annotator annotator = new Annotator("path/document.docx"))
{
    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.docx");
}

Вставте анотацію прямокутника або області до Word за допомогою C#

Під час додавання до документа будь-яку анотацію можна налаштувати. Нижче наведено кроки для додавання анотації прямокутника або області до документа DOC/DOCX із деякими налаштуваннями. Це дуже схоже на додавання анотацій Arrow, але цього разу використовує клас AreaAnnotation.

Завантажте документ DOC/DOCX за допомогою класу Annotator.
Ініціалізуйте анотацію прямокутника за допомогою класу AreaAnnotation.
Налаштуйте положення, розмір і колір прямокутника.
Встановіть інші властивості, наприклад номер сторінки, фон, непрозорість, стиль, ширину пера, повідомлення та час.
Додайте створену прямокутну анотацію до Анотатора.
Збережіть анотований файл у шлях за допомогою методу Save.

Програмно додайте анотацію прямокутника або області в .NET і Java

У наведеному нижче прикладі коду показано, як додати анотацію прямокутника/області до документа Word за допомогою C#.

// Додайте анотацію області або прямокутника в документи Word за допомогою C#
using (Annotator annotator = new Annotator("path/document.docx"))
{
    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.docx");
}

Додавання овальної або еліптичної анотації до Word за допомогою C#

Нижче наведено кроки для додавання овальної або еліптичної анотації до документа на C#.

Програмно додайте еліпси або овальні анотації в C# .NET і Java

Завантажте документ DOC/DOCX за допомогою класу Annotator.
Ініціалізуйте анотацію еліпса за допомогою класу EllipseAnnotation.
Встановіть положення та розмір ініціалізованої анотації еліпса.
Додайте створену анотацію еліпса до об’єкта Annotator.
Укажіть шлях і збережіть анотований файл Word за допомогою методу Save.

У наведеному нижче прикладі коду показано, як додати овал або еліпс анотації до документа Word за допомогою C#.

// Додавання овальної або еліптичної анотації в документи Word за допомогою C#
using (Annotator annotator = new Annotator("path/document.docx"))
{
    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.docx");
}

Вставте анотацію відстані до Word за допомогою C#

Так само ви можете додати анотацію відстані, щоб позначити відстань між двома точками. Нижче наведено кроки, щоб додати анотацію відстані до документа.

Програмно додайте анотацію відстані в C# .NET і Java

Після завантаження документа Word ініціалізуйте анотацію відстані за допомогою класу DistanceAnnotation.
Налаштувати зовнішній вигляд анотації.
Додайте анотацію відстані до об’єкта Annotator.
Збережіть анотовані файли Word у вказаному місці, вказавши шлях.

У наведеному нижче прикладі коду показано, як додати анотацію відстані до документа DOC/DOCX за допомогою C#.

// Додайте анотацію «Відстань» до документів Word за допомогою C#
using (Annotator annotator = new Annotator("path/document.docx"))
{
    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.docx");
}

Повний код

Підводячи підсумок, ось повний код із результатом, що показує всі додані анотації та повідомлення з відповідями. Наведений нижче код C# додає стрілку, прямокутник, еліпс, анотації відстані, повідомлення та відповіді до файлу Word.

// Додайте кілька анотацій до Word за допомогою C#
// Додавання анотацій стрілка, площа, овал (еліпс), відстань до DOC/DOCX із повідомленнями та відповідями за допомогою C#
string outputPath = @"outputPath/annotatedDoc.docx";
string inputFile = @"inputPath/document.docx";

using (Annotator annotator = new Annotator(inputFile))
{
    ArrowAnnotation arrow = new ArrowAnnotation
    {
        Box = new Rectangle(550, 250, 60, -60),
        CreatedOn = DateTime.Now,
        Message = "This image is little upwards.",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -3407872,
        PenStyle = PenStyle.Solid,
        PenWidth = 2,
        Replies = new List<Reply>
        {
            new Reply
            {
                Comment = "Please look in to these issues.",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                    Comment = "Change Description",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "On-Premises APIs",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "Add images as well.",
                RepliedOn = DateTime.Now
            }
        }
    };
    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
    };
    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
    };
    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(arrow);
    annotator.Add(area);
    annotator.Add(ellipse);
    annotator.Add(distance);

    annotator.Save(outputPath);
}

Видалення анотацій із файлів Word DOC/DOCX за допомогою C#

Анотації з документів можна легко видалити. Існує багато варіантів видалення анотацій із документа Word. Ви можете видалити всі анотації одночасно. Крім того, ви можете надати індекси, щоб видалити певні анотації. Щоб отримати додаткові параметри, перегляньте статтю документація.

Нижче наведено кроки, щоб видалити всі анотації з файлу Word.

Завантажте документ.
Ініціалізуйте параметри збереження за допомогою класу SaveOptions.
Встановіть для типів анотацій значення «Немає».
Збережіть файл Word. У ньому не буде жодної анотації.

Наступний код показує, як видалити анотації з файлу Word за допомогою C#.

// Видаліть усі анотації з документа Word за допомогою C#
using (Annotator annotator = new Annotator(outputPath))
{
    annotator.Save(remOutputPath, new SaveOptions {AnnotationTypes = AnnotationType.None});
}

Висновок

Коротше кажучи, ви дізналися, як додавати анотації до документів Word у програмах .NET за допомогою C#. Зокрема, ми додали анотації стрілок, еліпса, площі та відстані до файлу Word DOC/DOCX. Крім того, ви також бачили, як видалити всі анотації з будь-якого файлу Word. Тепер ви можете створити власну програму .NET анотатора документів.

Дізнайтеся більше про GroupDocs.Annotation for .NET із документації і репозиторію GitHub. Щоб отримати додаткові запитання, зверніться до служби підтримки на форумі.

.NET API для анотування та розмітки файлів Word#

Додайте анотації до Word у C##

Додайте анотацію зі стрілкою до Word за допомогою C##

Вставте анотацію прямокутника або області до Word за допомогою C##

Додавання овальної або еліптичної анотації до Word за допомогою C##

Вставте анотацію відстані до Word за допомогою C##

Повний код#

Видалення анотацій із файлів Word DOC/DOCX за допомогою C##

Висновок#

Дивись також#