Microsoft Word 使您能够向 Word 文档添加注释。在建议改进文档或分享对文本的想法等情况下,评论可能会有所帮助。在某些情况下,您可能需要以编程方式管理评论。为此,本文将教您如何使用 C++ 处理 Word 文档中的注释。

用于处理 Word 文档中的注释的 C++ API

Aspose.Words for C++ 是一个本地 C++ 库,允许您创建、读取、修改和转换 Microsoft Word 文档。此外,它还支持处理 DOCXDOC 文件中的注释。您可以通过 NuGet 安装 API,也可以直接从 下载 部分下载。

PM> Install-Package Aspose.Words.Cpp

使用 C++ 向 Word 文档添加注释

Aspose.Words for C++ API 提供了添加带有作者姓名、首字母缩写和日期/时间的评论的能力。以下是向 Word 文档添加注释的步骤。

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

// 目录路径。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";

// 加载 Word 文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"Sample 1.docx");

// 创建 DocumentBuilder 类的实例
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

// 添加评论
System::SharedPtr<Comment> comment = System::MakeObject<Comment>(doc, u"Aspose", u"AFFA", System::DateTime::get_Today());
builder->get_CurrentParagraph()->AppendChild(comment);
comment->get_Paragraphs()->Add(System::MakeObject<Paragraph>(doc));
comment->get_FirstParagraph()->get_Runs()->Add(System::MakeObject<Run>(doc, u"Comment text."));

// 保存文档。
doc->Save(outputDataDir + u"AddCommentsToExistingDoc.docx");

以下是示例代码生成的输出图像。

示例代码生成的输出图像

从 Word 文档中读取评论

以下是从 Word 文档中读取注释的步骤。

以下是使用 C++ 从 Word 文档中读取注释的示例代码。

// 目录路径。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";

// 加载 Word 文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");

// 检索评论
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);

// 循环浏览所有评论
for (System::SharedPtr<Comment> comment : System::IterateOver<System::SharedPtr<Comment>>(comments))
{
	// 打印评论信息
	std::cout << comment->get_Author() + u" " + comment->get_DateTime() + u" " + System::StaticCast<Node>(comment)->ToString(SaveFormat::Text);
}

使用 C++ 修改 Word 文档中的注释

要修改评论,请使用 NodeCollection->idxget(int32t index) 方法检索它并根据您的需要进行更改。以下是修改 Word 文档中的注释的步骤。

以下示例代码展示了如何使用 C++ 修改 Word 文档中的注释。

// 目录路径。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";

// 加载 Word 文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");

// 检索评论
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);

// 获取评论
System::SharedPtr<Comment> comment = System::DynamicCast<Comment>(comments->idx_get(0));

// 更新评论文本
comment->SetText(u"Updated Text");

// 保存文档。
doc->Save(outputDataDir + u"UpdatedComment.docx");

使用 C++ 从 Word 文档中删除注释

Aspose.Words for C++ API 提供了多种从 Word 文档中删除注释的方法。在本节中,您将学习如何使用 C++ 删除特定评论、作者评论和所有评论。

删除特定评论

以下是删除特定评论的步骤。

以下示例代码显示如何使用 C++ 从 Word 文档中删除特定注释。

// 目录路径。
System::String sourceDataDir = u"D:\\Work\\Aspose\\01_SourceDirectory\\";
System::String outputDataDir = u"D:\\Work\\Aspose\\02_OutputDirectory\\";

// 加载 Word 文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");

// 检索评论
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);

// 获取评论
System::SharedPtr<Comment> comment = System::DynamicCast<Comment>(comments->idx_get(2));

// 删除评论
comment->Remove();

// 保存文档。
doc->Save(outputDataDir + u"DeleteSpecificComments.docx");

按作者删除评论

以下是按作者删除评论的步骤。

以下是作者使用 C++ 删除评论的示例代码。

// 目录路径。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";

// 加载 Word 文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");

// 检索评论
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);

// 循环浏览所有评论并删除“Aspose”作者所写的评论。
for (int32_t i = comments->get_Count() - 1; i >= 0; i--)
{
	System::SharedPtr<Comment> comment = System::DynamicCast<Comment>(comments->idx_get(i));
	if (comment->get_Author() == u"Aspose")
	{
		comment->Remove();
	}
}

// 保存文档。
doc->Save(outputDataDir + u"DeleteCommentsByAuthor.docx");

删除所有评论

您可以使用 NodeCollection->Clear() 方法一次删除所有评论,而不是删除单个评论。以下是从 Word 文档中删除所有评论的步骤。

以下示例代码演示了如何使用 C++ 从 Word 文档中删除所有注释。

// 目录路径。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";

// 加载 Word 文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");

// 检索评论
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);

// 删除所有评论。
comments->Clear();

// 保存文档。
doc->Save(outputDataDir + u"DeleteAllComments.docx");

获得免费许可证

您可以通过申请 免费的临时许可证 来试用该 API,而不受评估限制。

结论

在本文中,您学习了如何使用 C++ 在 Word 文档中处理注释。具体来说,您已经学习了如何添加、阅读、编辑和删除评论。此外,您还了解了如何使用 Aspose.Words for C++ API 删除特定评论、作者评论和所有评论。该 API 提供了大量附加功能,用于自动执行与 Word 相关的任务。您可以通过访问 官方文档 来详细探索 API。如有任何问题,请随时通过我们的 免费支持论坛 与我们联系。

也可以看看