Microsoft Word 使您能够向 Word 文档添加注释。在建议改进文档或分享对文本的想法等情况下，评论可能会有所帮助。在某些情况下，您可能需要以编程方式管理评论。为此，本文将教您如何使用 C++ 处理 Word 文档中的注释。
- 用于处理 Word 文档中的注释的 C++ API
- 使用 C++ 向 Word 文档添加注释
- 从 Word 文档中读取评论
- 使用 C++ 修改 Word 文档中的注释
- 使用 C++ 从 Word 文档中删除注释
用于处理 Word 文档中的注释的 C++ API
Aspose.Words for C++ 是一个本地 C++ 库，允许您创建、读取、修改和转换 Microsoft Word 文档。此外，它还支持处理 DOCX 和 DOC 文件中的注释。您可以通过 NuGet 安装 API，也可以直接从 下载 部分下载。
PM> Install-Package Aspose.Words.Cpp
使用 C++ 向 Word 文档添加注释
Aspose.Words for C++ API 提供了添加带有作者姓名、首字母缩写和日期/时间的评论的能力。以下是向 Word 文档添加注释的步骤。
- 首先，使用 Document 类加载 Word 文档。
- 通过传递在上一步中创建的 Document 对象来创建 DocumentBuilder 类的实例。
- 使用 Comment 类创建评论。
- 使用 DocumentBuilder->getCurrentParagraph()->AppendChild(System::SharedPtr) 将注释添加到文档Aspose::Words::NodenewChild) 方法。
- 最后，使用 Document->Save(System::String fileName) 方法保存文档。
以下示例代码演示了如何使用 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 文档中读取注释的步骤。
- 使用 Document 类加载 Word 文档。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法检索注释。
- 遍历评论并检索各个评论的信息。
以下是使用 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 文档中的注释的步骤。
- 首先，使用 Document 类加载 Word 文档。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法检索注释。
- 使用 NodeCollection->idxget(int32t index) 方法获取所需的注释并将结果转换为 Comment。
- 更新评论。
- 最后，使用 Document->Save(System::String fileName) 方法保存文档。
以下示例代码展示了如何使用 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++ 删除特定评论、作者评论和所有评论。
删除特定评论
以下是删除特定评论的步骤。
- 使用 Document 类加载 Word 文档。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法检索注释。
- 使用 NodeCollection->idxget(int32t index) 方法获取要删除的评论并将结果转换为 Comment。
- 使用 Comment->Remove() 方法删除评论。
- 使用 Document->Save(System::String fileName) 方法保存文档。
以下示例代码显示如何使用 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");
按作者删除评论
以下是按作者删除评论的步骤。
- 首先，使用 Document 类加载 Word 文档。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法检索注释。
- 循环浏览评论。
- 在循环中，检索评论并比较其作者。如果作者匹配，请删除评论。
- 最后，使用 Document->Save(System::String fileName) 方法保存文档。
以下是作者使用 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 文档中删除所有评论的步骤。
- 使用 Document 类加载 Word 文档。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法检索注释。
- 使用 NodeCollection->Clear() 方法删除所有注释。
- 最后，使用 Document->Save(System::String fileName) 方法保存文档。
以下示例代码演示了如何使用 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。如有任何问题，请随时通过我们的 免费支持论坛 与我们联系。