Word处理控件Aspose.Words功能演示：使用 C++ 处理 Word 文档中的目录

我不是女神ヾ 2023-09-23 23:56 137阅读 0赞

[Aspose API][]支持流行文件格式处理，并允许将各类文档导出或转换为固定布局文件格式和最常用的图像/多媒体格式。

Aspose.words是一种高级Word文档处理API，用于执行各种文档管理和操作任务。API支持生成，修改，转换，呈现和打印文档，而无需在跨平台应用程序中直接使用Microsoft Word。此外，API支持所有流行的Word处理文件格式，并允许将Word文档导出或转换为固定布局文件格式和最常用的图像/多媒体格式。

目录 (TOC) 是 Word 文档的重要组成部分。它提供文档内容的概述，并允许您快速导航到所需的部分。您可能会发现自己需要以编程方式从 Word 文档中添加、提取、更新或删除目录。为此，本文将教您**如何使用 C++ 处理 Word 文件中的目录**。

**一、下载用于处理 Word 文档中的目录的 C++ API**

Aspose.Words for C++是一个原生 C++ 库，允许您创建、阅读、修改和转换 Microsoft Word 文档。此外，它还支持处理 Word 文件中的目录。您可以通过NuGet安装 API，也可以直接从“下载”部分下载。

>     PM> Install-Package Aspose.Words.Cpp

**二、在 Word 文档中添加目录**

以下是在 Word 文档中添加目录的步骤。

*  使用Document类加载 Word 文件。
 *  使用之前创建的Document对象创建DocumentBuilder类的实例。
 *  使用DocumentBuilder->InsertTableOfContents(System::String 开关)方法插入目录。
 *  使用Document->UpdateFields()方法填充目录。
 *  使用Document->Save(System::String fileName)方法保存 Word 文档。

以下示例代码展示了如何使用 C++ 在 Word 文档中添加目录。

>     // Source and output directory paths.
>     System::String sourceDataDir = u"SourceDirectory\\";
>     System::String outputDataDir = u"OutputDirectory\\";
>     
>     // Load the Word file
>     System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"Sample 5.docx");
>     
>     // Create an instance of the DocumentBuilder class
>     System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);
>     
>     // Insert a table of contents at the beginning of the document.
>     builder->InsertTableOfContents(u"\\o \"1-3\" \\h \\z \\u");
>     
>     // The newly inserted table of contents will be initially empty.
>     // It needs to be populated by updating the fields in the document.
>     doc->UpdateFields();
>     
>     // Output file path
>     System::String outputPath = outputDataDir + u"AddTOC.docx";
>     
>     // Save the Word file
>     doc->Save(outputPath);

![72089bcddc558777dc30efec630d338b.png][]

**三、从 Word 文档中提取目录**

以下是从 Word 文档中提取目录的步骤。

*  使用Document类加载 Word 文件。
 *  使用Document->get\_Range()->get\_Fields()方法检索字段并遍历它们。
 *  检查字段是否为FieldType::FieldHyperlink类型。
 *  检查该字段是否属于目录。
 *  检索并打印字段信息。

以下示例代码演示了如何使用 C++ 从 Word 文档中提取目录。

>     // Source direvctory
>     System::String inputDataDir = u"SourceDirectory\\";
>     
>     // Load the Word file
>     System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"SampleTOC.docx");
>     
>     // Loop through the fields
>     for (System::SharedPtr<Field> field : System::IterateOver(doc->get_Range()->get_Fields()))
>     {
>     // Get FieldHyperlink fields
>     if (field->get_Type() == FieldType::FieldHyperlink)
>     {
>     System::SharedPtr<FieldHyperlink> hyperlink = System::DynamicCast<FieldHyperlink>(field);
>     
>     // Check if field belongs to TOC
>     if (hyperlink->get_SubAddress() != nullptr && hyperlink->get_SubAddress().StartsWith(u"_Toc"))
>     {
>     System::SharedPtr<Paragraph> tocItem = System::DynamicCast<Paragraph>(field->get_FieldStart()->GetAncestor(NodeType::Paragraph));
>     std::cout << System::StaticCast<Node>(tocItem)->ToString(SaveFormat::Text).Trim().ToUtf8String() << std::endl;
>     std::cout << "------------------" << std::endl;
>     if (tocItem != nullptr)
>     {
>     System::SharedPtr<Bookmark> bm = doc->get_Range()->get_Bookmarks()->idx_get(hyperlink->get_SubAddress());
>     
>     // Get the location this TOC Item is pointing to
>     System::SharedPtr<Paragraph> pointer = System::DynamicCast<Paragraph>(bm->get_BookmarkStart()->GetAncestor(NodeType::Paragraph));
>     std::cout << System::StaticCast<Node>(pointer)->ToString(SaveFormat::Text).ToUtf8String() << std::endl;
>     }
>     }
>     }
>     }

**四、更新 Word 文档中的目录**

如果文档的内容已经更新，并且您需要在目录中反映这些更改，您只需加载 Word 文件并调用[Document->UpdateFields()][Document-_UpdateFields]方法。该方法会根据修改后的内容更新目录。在此之后，保存更新的 Word 文档。

**五、从 Word 文档中删除目录**

以下是从 Word 文档中删除目录的步骤。

*  使用Document类加载 Word 文件。
 *  检索并存储FieldStart节点的列表。
 *  循环遍历节点，直到到达指定目录结尾的NodeType::FieldEnd类型的节点。
 *  使用Node->Remove()方法删除目录。
 *  使用Document->Save(System::String fileName)方法保存 Word 文档。

以下示例代码显示如何使用 C++ 从 Word 文档中删除目录。

>     void RemoveTableOfContents(const System::SharedPtr<Document>& doc, int32_t index)
>     {
>     // Store the FieldStart nodes of TOC fields in the document for quick access.
>     std::vector<System::SharedPtr<FieldStart>> fieldStarts;
>     // This is a list to store the nodes found inside the specified TOC. They will be removed
>     // at the end of this method.
>     std::vector<System::SharedPtr<Node>> nodeList;
>     
>     for (System::SharedPtr<FieldStart> start : System::IterateOver<System::SharedPtr<FieldStart>>(doc->GetChildNodes(NodeType::FieldStart, true)))
>     {
>     if (start->get_FieldType() == FieldType::FieldTOC)
>     {
>     // Add all FieldStarts which are of type FieldTOC.
>     fieldStarts.push_back(start);
>     }
>     }
>     
>     // Ensure that the TOC specified by the passed index exists.
>     if (index > fieldStarts.size() - 1)
>     {
>     throw System::ArgumentOutOfRangeException(u"TOC index is out of range");
>     }
>     
>     bool isRemoving = true;
>     
>     // Get the FieldStart of the specified TOC.
>     System::SharedPtr<Node> currentNode = fieldStarts[index];
>     
>     while (isRemoving)
>     {
>     // It is safer to store these nodes and delete them all at once later.
>     nodeList.push_back(currentNode);
>     currentNode = currentNode->NextPreOrder(doc);
>     
>     // Once we encounter a FieldEnd node of type FieldTOC then we know we are at the end
>     // of the current TOC and we can stop here.
>     if (currentNode->get_NodeType() == NodeType::FieldEnd)
>     {
>     System::SharedPtr<FieldEnd> fieldEnd = System::DynamicCast<FieldEnd>(currentNode);
>     if (fieldEnd->get_FieldType() == FieldType::FieldTOC)
>     {
>     isRemoving = false;
>     }
>     }
>     }
>     
>     // Remove all nodes found in the specified TOC.
>     for (System::SharedPtr<Node> node : nodeList)
>     {
>     node->Remove();
>     }
>     }
>     
>     int main()
>     {
>     // Source and output directory paths.
>     System::String sourceDataDir = u"SourceDirectory\\";
>     System::String outputDataDir = u"OutputDirectory\\";
>     
>     // Open a Word document
>     System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleTOC.docx");
>     
>     // Remove the first table of contents from the document.
>     RemoveTableOfContents(doc, 0);
>     
>     // Output file path
>     System::String outputPath = outputDataDir + u"RemoveTOC.docx";
>     
>     // Save the Word file
>     doc->Save(outputPath);
>     }

以上便是使用 C++ 在 Word 文档中添加或删除页眉和页脚详细步骤 ，要是您还有其他关于产品方面的问题，欢迎咨询我们，或者加入我们官方技术交流群。

[Aspose API]: https://www.evget.com/supplier/150
[72089bcddc558777dc30efec630d338b.png]: https://img-blog.csdnimg.cn/img_convert/72089bcddc558777dc30efec630d338b.png
[Document-_UpdateFields]: https://reference.aspose.com/words/cpp/class/aspose.words.document#a9c2187d845fae7a8dd8a6a5241d69d25