使用部分
有时您想要的文档在所有页面上没有相同的格式。 例如,您可能需要修改页码格式,具有不同的页面大小和方向,或者将第一个文档页面作为封面页,而无需任何编号。 你可以用部分来实现这一点。
节是控制页眉和页脚、方向、列、边距、页码格式等的级别节点。
Aspose.Words允许您管理部分,将文档划分为部分,并进行仅适用于特定部分的格式更改。 Aspose.Words存储有关节格式的信息,如页眉和页脚、页面设置和节间隔中的列设置。
本文介绍了如何使用节和节间隔。
什么节和节休息是
文档部分由Section和SectionCollection类表示。 节对象是Document节点的直接子节点,可以通过Sections属性访问。 您可以使用一些方法来管理这些节点,例如Remove, Add, IndexOf, 和其他人。
Section break是将文档页面划分为具有可自定义布局的部分的选项。
分段中断的类型
Aspose.Words允许您使用BreakType枚举的不同分节符分割和格式化文档:
- SectionBreakContinuous
- SectionBreakNewColumn
- SectionBreakNewPage
- SectionBreakEvenPage
- SectionBreakOddPage
您还可以使用SectionStart枚举来选择仅适用于第一节的中断类型,例如NewColumn, NewPage, EvenPage, 和OddPage。
管理一个部分
由于节是一个普通的复合节点,因此整个节点操作API可用于操作节:对节进行添加、删除和其他操作。 您可以在文章中阅读有关节点的更多信息 Aspose.Words文档对象模型(DOM).
另一方面,您也可以使用DocumentBuilder
API来处理部分。 在本文中,我们将重点介绍使用部分的这种特殊方式。
插入或删除断点
Aspose.Words允许您使用InsertBreak方法在文本中插入分段中断。
下面的代码示例演示如何在文档中插入分隔符:
使用Remove方法删除分段中断。 如果您不需要删除特定的节中断,而是删除该节的内容,则可以使用ClearContent方法。
下面的代码示例演示如何删除分隔符:
移动一个部分
如果要将文档中的某个部分从一个位置移动到另一个位置,则需要获取该部分的索引。 Aspose.Words允许您从SectionCollection中获取节位置。 您可以使用Sections属性获取文档中的所有部分。 但是如果你只想获得第一个部分,你可以使用FirstSection属性。
下面的代码示例演示如何访问第一个部分并遍历复合节点的子节点:
指定节布局
有时,您希望通过为不同的文档部分制作创意布局来使文档看起来更好。 如果要指定当前节网格的类型,可以使用SectionLayoutMode枚举选择节布局模式:
- 违约情况
- 网格
- LineGrid
- SnapToChars
下面的代码示例演示如何限制每个页面可能具有的行数:
编辑部分
当您向文档添加新部分时,将没有您可以编辑的正文或段落。 Aspose.Words允许您使用EnsureMinimum方法保证一个部分包含至少有一个段落的正文-它会自动向文档添加一个正文(或HeaderFooter)节点,然后向其添加一个段落。
下面的代码示例演示如何使用EnsureMinimum准备新的节节点:
追加或追加内容
如果要在部分的开头/结尾绘制一些形状或添加文本或图像,可以使用Section类的AppendContent和PrependContent方法。
下面的代码示例演示如何附加现有部分的内容:
克隆一个部分
Aspose.Words允许您通过使用deepClone方法创建节的完整副本来复制节。
下面的代码示例演示如何克隆文档中的第一个部分:
在文档之间复制部分
在某些情况下,您可能有许多节的大型文档,并且您希望将节的内容从一个文档复制到另一个文档。
Aspose.Words允许您使用ImportNode方法在文档之间复制部分。
下面的代码示例演示如何在文档之间复制节:
使用节页眉和页脚
为每个部分显示页眉或页脚的基本规则非常简单:
- 如果该节没有自己的特定类型的页眉/页脚,则它取自上一节。
- 页面上显示的页眉/页脚类型由"不同的第一页"和"不同的奇数和偶数页"部分设置控制–如果它们被禁用,则忽略该部分自己的标题。
下面的代码示例演示如何创建具有不同标题的2个部分:
如果要删除页眉和页脚的文本而不删除文档中的HeaderFooter对象,则可以使用ClearHeadersFooters方法。 此外,您可以使用DeleteHeaderFooterShapes方法从文档中的页眉和页脚中删除所有形状。
下面的代码示例演示如何清除部分中所有页眉和页脚的内容:
下面的代码示例如何从节中的所有页眉页脚中删除所有形状:
自定义部分中的页面属性
在打印页面或文档之前,您可能需要自定义和修改单个页面或整个文档的大小和布局。 通过页面设置,您可以更改文档页面的设置,如边距、方向和大小,以打印不同的第一页或奇数页。
Aspose.Words允许您使用PageSetup类自定义页面和部分属性。
下面的代码示例演示如何为当前节设置页面大小和方向等属性:
下面的代码示例演示如何修改所有部分中的页属性: