使用样式

StyleCollection类用于管理内置设置并将用户定义的设置应用于样式。

如何根据样式提取内容

在一个简单的层面上，从Word文档中检索基于样式的内容对于识别，列出和计数使用特定样式格式化的文本的段落和运行非常有用。例如，您可能需要识别文档中的特定类型的内容，例如示例、标题、参考文献、关键字、人物名称和案例研究。

为了更进一步，这也可以用来利用文档的结构（由它使用的样式定义），将文档重新用于另一个输出（如HTML）。这实际上是Aspose文档的构建方式，将Aspose.Words放到测试中。使用Aspose.Words构建的工具获取源Word文档并将其拆分为某些标题级别的主题。使用Aspose.Words生成XML文件，该文件用于构建您可以在左侧看到的导航树。然后Aspose.Words将每个主题转换为HTML。

在Word文档中检索使用特定样式格式化的文本的解决方案通常使用Aspose.Words既经济又简单。

解决方案

为了说明Aspose.Words如何轻松处理基于样式的检索内容，让我们看一个例子。在此示例中，我们将从示例Word文档中检索使用特定段落样式和字符样式格式化的文本。在高层次上，这将涉及:

使用Document类打开Word文档。
获取文档中所有段落和所有段落的集合。
只选择所需的段落和运行。具体来说，我们将从这个示例Word文档中检索使用"标题1"段落样式和"强烈强调"字符样式格式化的文本。

working-with-styles-aspose-words-cpp-1

在这个示例文档中，使用"标题1"段落样式格式化的文本是"插入选项卡"、“快速样式"和"主题”，而使用"强烈强调"字符样式格式化的文本是蓝色、斜体、粗体文本的几个实例，如"画廊"和"整体外观"。

守则

在Aspose.Words文档对象模型中，基于样式的查询的实现非常简单，因为它只使用已经存在的工具。为此解决方案实现了两个类方法：#ParagraphsByStyleName-此方法检索文档中具有特定样式名称的段落的数组。#RunsByStyleName–此方法检索文档中具有特定样式名称的运行的数组。这两种方法非常相似，唯一的区别是节点类型以及段落和运行节点中样式信息的表示。下面是ParagraphsByStyleName的实现。下面的示例查找使用指定样式格式化的所有段落。

此实现还使用Document类的Document.GetChildNodes方法，该方法返回具有指定类型的所有节点的集合，在本例中为所有段落。

请注意，Document.GetChildNodes方法的第二个参数设置为true。这迫使Document.GetChildNodes方法递归地从所有子节点中进行选择，而不是仅选择直接子节点。

还值得指出的是，段落集合不会产生即时开销，因为只有当您访问其中的项时，段落才会加载到此集合中。然后，您需要做的就是通过集合，使用每个运算符的标准，并将具有指定样式的段落添加到paragraphsWithStyle数组中。可以在样式中找到Paragraph样式名称。 Paragraph.ParagraphFormat对象的Name属性。 RunsByStyleName的实现几乎是相同的，尽管我们显然使用NodeType.Run来检索运行节点。 Run对象的Font.Style属性用于访问Run节点中的样式信息。 Below code示例查找使用指定样式格式化的所有运行。

当两个查询都实现时，您需要做的就是传递一个document对象并指定要检索的内容的样式名称：下面的示例运行查询并显示结果。您可以从这里下载此示例的模板文件。

最终结果

完成所有操作后，运行示例将显示以下输出:

working-with-styles-aspose-words-cpp-2

正如您所看到的，这是一个非常简单的示例，显示了收集的段落的数量和文本，并在示例Word文档中运行。

如何插入和使用目录字段

通常，您将处理包含目录（TOC）的文档。使用Aspose.Words，您可以插入自己的目录，或者只需几行代码就可以完全重建文档中现有的目录。本文概述了如何使用目录字段并演示:

如何插入一个全新的TOC
更新文档中的新的或现有的TOCs。
指定开关以控制TOC的格式和整体结构。
如何修改目录的样式和外观.
如何从文档中删除整个TOC字段以及所有条目。

插入TC字段

通常为TOC指定特定的文本行，并用TC字段标记。在MSWord中执行此操作的简单方法是突出显示文本并按ALT+SHIFT+O。这会使用所选文本自动创建TC字段。同样的技术可以通过代码来完成。下面的代码将找到与输入匹配的文本，并在与文本相同的位置插入TC字段。该代码基于文章中使用的相同技术。下面的示例演示如何在文档中的文本中查找和插入TC字段。

修改目录

更改样式的格式

TOC中的条目格式不使用标记条目的原始样式，而是使用等效的TOC样式对每个级别进行格式设置。例如，TOC中的第一级用TOC1样式格式化，第二级用TOC2样式格式化等等。这意味着要更改TOC的外观，必须修改这些样式。在Aspose.Words中，这些样式由区域设置独立的StyleIdentifier.TOC1到StyleIdentifier.TOC9表示，可以使用这些标识符从Document.Styles集合中检索。一旦检索到文档的适当样式，就可以修改该样式的格式。对这些样式的任何更改都将自动反映在文档中的TOCs上。 Below code示例更改第一级TOC样式中使用的格式属性。

还需要注意的是，标记为包含TOC的段落的任何直接格式（定义在段落本身而不是样式中）将被复制到TOC的条目中。例如，如果标题1样式用于标记TOC的内容，并且此样式具有粗体格式，而段落也直接应用斜体格式。生成的TOC条目不会是粗体，因为这是样式格式的一部分，但是它将是斜体，因为这是直接在段落上格式化的。您还可以控制每个条目和页码之间使用的分隔符的格式。默认情况下，这是一条虚线，使用制表符和靠近右边距的右制表位排列在页面编号上。

使用为要修改的特定TOC级别检索的Style类，还可以修改这些在文档中的显示方式。要更改它的显示方式，首先必须调用Style.ParagraphFormat来检索样式的段落格式。由此，可以通过调用ParagraphFormat.TabStops检索选项卡停止，并修改相应的选项卡停止。使用相同的技术，选项卡本身可以完全移动或删除。 Below code示例演示如何修改TOC相关段落中右制表符停止的位置。您可以从这里下载此示例的模板文件。

从文档中删除目录

通过删除TOC字段的FieldStart和FieldEnd节点之间找到的所有节点，可以从文档中删除目录。下面的代码演示了这一点。删除TOC字段比普通字段简单，因为我们不跟踪嵌套字段。相反，我们检查FieldEnd节点的类型为FieldType.FieldTOC，这意味着我们遇到了当前TOC的结尾。在这种情况下可以使用这种技术，而不必担心任何嵌套字段，因为我们可以假设任何正确形成的文档在另一个TOC字段中没有完全嵌套的TOC字段。首先收集并存储每个TOC的FieldStart节点。然后枚举指定的TOC，以便访问并存储字段中的所有节点。然后从文档中删除节点。 Below code示例演示如何从文档中删除指定的TOC。您可以从这里下载此示例的模板文件。

插入样式分隔符以放置不同的段落样式

可以使用Ctrl+Alt+Enter键盘快捷键将样式分隔符添加到段落的末尾MS字。此功能允许在一个逻辑打印段落中使用两种不同的段落样式。如果您希望某个特定标题开头的某些文本出现在内容列表中，但不希望整个标题出现在内容列表中，则可以使用此功能。 Below code示例演示如何插入样式分隔符以放置不同的段落样式。

从模板复制所有样式

有些情况下，您希望将所有样式从一个文档复制到另一个文档中。您可以使用Document.CopyStylesFromTemplate方法将样式从指定模板复制到文档。当样式从模板复制到文档时，文档中的类似命名样式将被重新定义以匹配模板中的样式描述。模板中的唯一样式将复制到文档中。文档中的唯一样式保持不变。 Below code示例演示如何将样式从一个文档复制到另一个文档中。

在C++中查找和替换使用C++中的部分