使用 C# 添加或删除注释或标记 Word 文件

忘记在长电子邮件线程中讨论文档的内容和反馈。只需使用注释来标记带有消息和回复的文档。在本文中，您将学习如何使用 .NET 应用程序以编程方式添加和删除注释以标记 C# 中的 Word 文档。

以下是以下简要讨论的主题：

• .NET API for Word DOC/DOCX Annotations
• 为Word添加注释
  • 箭头注释
  • 矩形注释
  • 椭圆或椭圆注释
  • 距离注释
• 从 Word 文件中删除注释

.NET API 用于注释和标记 Word 文件

GroupDocs.Annotation 提供 .NET API 来处理 .NET 应用程序中文档和图像的注释。该 API 允许您从 Word 文档中添加、删除和提取注释。此外，它还支持电子表格、演示文稿、图像、PDF 文件、网页、电子邮件、Visio 绘图。一些 AutoCAD 绘图和 DICOM 等数字成像格式也在列表中。有关 注释支持的文档格式 的完整列表，您可以访问文档。

从 下载部分 下载 DLLs 或 MSI 安装程序，或通过 NuGet 在您的 .NET 应用程序中安装 API。您也可以使用包管理器中的以下命令。

PM> Install-Package GroupDocs.Annotation

在 C# 中为 Word 添加注释

让我们在 Word 文档中添加一些不同类型的注释。有许多不同类型的注释，因此我们将在本文中仅介绍其中的几个。

有一些受支持的注释类型，您可以单独了解每个注释。

• 面积/矩形标注
• 箭
• 下划线
• 水印
• 距离
• 三振出局
• 文本域
• 椭圆
• 强调
• 关联
• 观点
• 折线
• 替换
• 资源编辑
• 文本编辑

使用 C# 在 Word 中添加箭头注释

以下是在 C# 中向 Word 文档添加箭头注释的步骤。

• 使用 Annotator 类加载文档。
• 使用 ArrowAnnotation 类初始化箭头注释。
• 调整箭头标注的位置、大小、页码。
• 使用 Add 方法添加创建的箭头注释。
• 使用Save方法将带注释的Word文档保存到路径中。

以下代码示例演示如何使用 C# 向 Word 文档添加箭头注释。

// 使用 C# 向 Word 文档添加箭头注释
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");
}

使用 C# 在 Word 中插入矩形或区域注释

可以在将任何注释添加到文档时对其进行自定义。以下是通过一些自定义将矩形或区域注释添加到 DOC/DOCX 文档的步骤。它与添加箭头注释非常相似，但这次使用 AreaAnnotation 类。

• 使用 Annotator 类加载 DOC/DOCX 文档。
• 使用 AreaAnnotation 类初始化矩形标注。
• 调整矩形的位置、大小和颜色。
• 设置其他属性，如页码、背景、不透明度、样式、笔宽、消息和时间。
• 将创建的矩形注解添加到注解器中。
• 使用Save方法将注释文件保存到路径。

以下代码示例展示了如何使用 C# 向 Word 文档添加矩形/区域注释。

// 使用 C# 在 Word 文档中添加区域或矩形注释
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");
}

使用 C# 在 Word 中添加椭圆或椭圆注释

以下是在 C# 中向文档添加椭圆注释或椭圆注释的步骤。

• 使用 Annotator 类加载 DOC/DOCX 文档。
• 使用 EllipseAnnotation 类初始化椭圆注释。
• 设置初始化椭圆标注的位置和大小。
• 将创建的椭圆注释添加到 Annotator 对象中。
• 提供路径并使用Save方法保存带注释的Word文件。

以下代码示例演示如何使用 C# 向 Word 文档添加椭圆或椭圆注释。

// 使用 C# 在 Word 文档中添加椭圆或椭圆注释
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");
}

使用 C# 在 Word 中插入距离注释

同样，您可以添加距离注释来标记两点之间的距离。以下是向文档添加距离注释的步骤。

• 加载Word文档后，使用DistanceAnnotation类初始化距离标注。
• 设置注释的外观。
• 将距离注释添加到 Annotator 对象。
• 通过指定路径将带注释的 Word 文件保存在给定位置。

以下代码示例展示了如何使用 C# 向 DOC/DOCX 文档添加距离注释。

// 使用 C# 向 Word 文档添加距离注释
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");
}

完整代码

总而言之，这里是完整的代码，其输出显示了所有添加的 annotations 和 messages with replies。下面的 C# 代码向 Word 文件添加箭头、矩形、椭圆、距离注释、消息和回复。

// 使用 C# 向 Word 添加多个注释
// 使用 C# 向 DOC/DOCX 添加箭头、区域、椭圆(椭圆) 、距离注释以及消息和回复
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);
}

使用 C# 从 Word DOC/DOCX 文件中删除注释

可以轻松删除文档中的注释。有许多选项可以从 Word 文档中删除注释。您可以一次删除所有注释。此外，您可以提供索引以删除特定注释。有关更多选项，请访问 文档 文章。

以下是从 Word 文件中删除所有注释的步骤。

• 加载文档。
• 使用 SaveOptions 类初始化保存选项。
• 将注释类型设置为无。
• 保存 Word 文件。它将没有注释。

以下代码显示了如何使用 C# 从 Word 文件中删除注释。

// 使用 C# 从 Word 文档中删除所有注释
using (Annotator annotator = new Annotator(outputPath))
{
    annotator.Save(remOutputPath, new SaveOptions {AnnotationTypes = AnnotationType.None});
}

结论

简而言之，您已经学习了如何使用 C# 在 .NET 应用程序中向 Word 文档添加注释。具体来说，我们在 Word DOC/DOCX 文件中添加了箭头、椭圆、面积和距离注释。此外，您还了解了如何从任何 Word 文件中删除所有注释。现在，您可以考虑构建自己的文档注释器 .NET 应用程序。

从 documentation 和 GitHub 存储库了解有关 GroupDocs.Annotation for .NET 的更多信息。如需进一步查询，请联系 论坛 上的支持人员。

也可以看看

• 使用 C# 为图像添加水印
• 用Java注释PDF文件