Section

遗产： java.lang.Object, com.aspose.words.Node, com.aspose.words.CompositeNode

public class Section extends CompositeNode

表示文档中的单个部分。

要了解更多信息，请访问Working with Sections文档文章。

Section可以有一个getBody()最多一个HeaderFooter每个HeaderFooterType. Body和HeaderFooter节点可以在里面以任何顺序Section.

一个最小的有效部分需要有Body与一个Paragraph.

每个部分都有自己的一组属性，用于指定页面大小、方向、页边距等。

您可以使用创建部分的副本Node.deepClone(boolean).副本可以插入到相同或不同的文档中。

要添加、插入或删除整个部分，包括分节符和部分属性，请使用Sections目的。

要仅复制和插入节的内容，不包括分节符和节属性，请使用AppendContent和PrependContent方法。

构造器

构造函数	描述
Section(DocumentBase doc)	初始化 Section 类的新实例。

方法

方法	描述
accept(DocumentVisitor visitor)	接待来访者。
appendChild(Node newChild)	将指定节点添加到此节点的子节点列表的末尾。
appendContent(Section sourceSection)	在此部分末尾插入源部分内容的副本。
clearContent()	清除该部分。
clearHeadersFooters()	清除此部分的页眉和页脚。
clearSectionAttrs()
dd()
deepClone()	创建此部分的副本。
deepClone(boolean isCloneChildren)	创建节点的副本。
deleteHeaderFooterShapes()	从该部分的页眉和页脚中删除所有形状（绘图对象）。
ensureMinimum()	确保该部分包含一个段落的正文。
equals(Object arg0)
fetchInheritedSectionAttr(int key)
fetchSectionAttr(int key)
getAncestor(int ancestorType)
getAncestor(Class ancestorType)	获取指定对象类型的第一个祖先。
getBody()	返回Body节的子节点。
getChild(int nodeType, int index, boolean isDeep)
getChildNodes()	获取此节点的所有直接子节点。
getChildNodes(int nodeType, boolean isDeep)
getClass()
getContainer()
getCount()	获取此节点的直接子节点数。
getCurrentNode()
getCustomNodeId()	指定自定义节点标识符。
getDirectSectionAttr(int key)
getDocument()	获取此节点所属的文档。
getFirstChild()	获取节点的第一个子节点。
getHeadersFooters()	提供对节的页眉和页脚节点的访问。
getLastChild()	获取节点的最后一个子节点。
getNextMatchingNode(Node curNode)
getNextSibling()	获取紧跟在该节点之后的节点。
getNodeType()	退货NodeType.Section.
getPageSetup()	返回表示页面设置和部分属性的对象。
getParentNode()	获取此节点的直接父级。
getPreviousSibling()	获取紧接在该节点之前的节点。
getProtectedForForms()	如果该部分受表单保护，则为真。
getRange()	返回一个Range表示包含在该节点中的文档部分的对象。
getText()	获取此节点及其所有子节点的文本。
hasChildNodes()	如果此节点有任何子节点，则返回 true。
hashCode()
indexOf(Node child)	返回子节点数组中指定子节点的索引。
insertAfter(Node newChild, Node refChild)	在指定的引用节点之后立即插入指定的节点。
insertBefore(Node newChild, Node refChild)	将指定节点插入到紧靠指定引用节点之前。
isComposite()	返回 true，因为此节点可以有子节点。
iterator()	为该节点的子节点上的每个样式迭代提供支持。
nextPreOrder(Node rootNode)	根据前序树遍历算法获取下一个节点。
nodeTypeToString(int nodeType)
notify()
notifyAll()
prependChild(Node newChild)	将指定节点添加到此节点的子节点列表的开头。
prependContent(Section sourceSection)	在此部分的开头插入源部分内容的副本。
previousPreOrder(Node rootNode)	根据前序树遍历算法获取上一个节点。
remove()	从父级中移除自身。
removeAllChildren()	移除当前节点的所有子节点。
removeChild(Node oldChild)	删除指定的子节点。
removeSmartTags()	删除所有SmartTag当前节点的后代节点。
selectNodes(String xpath)	选择与 XPath 表达式匹配的节点列表。
selectSingleNode(String xpath)	选择与 XPath 表达式匹配的第一个节点。
setCustomNodeId(int value)	指定自定义节点标识符。
setProtectedForForms(boolean value)	如果该部分受表单保护，则为真。
setSectionAttr(int key, Object value)
toString()
toString(SaveOptions saveOptions)	使用指定的保存选项将节点的内容导出为字符串。
toString(int saveFormat)
wait()
wait(long arg0)
wait(long arg0, int arg1)

Section(DocumentBase doc)

public Section(DocumentBase doc)

初始化 Section 类的新实例。

创建该部分时，它属于指定的文档，但还不是文档的一部分并且ParentNode一片空白。

要将 Section 包含到文档中，请使用 Document.InsertAfter、Document.InsertBefore 或 Sections.Add 和 Section.Insert 方法。

参数：

范围	类型	描述
doc	DocumentBase	所有者文件。

accept(DocumentVisitor visitor)

public boolean accept(DocumentVisitor visitor)

接待来访者。

枚举此节点及其所有子节点。每个节点调用 DocumentVisitor 上的相应方法。

有关更多信息，请参阅访问者设计模式。

参数：

范围	类型	描述
visitor	DocumentVisitor	将访问节点的访问者。

退货： boolean - 如果所有节点都被访问，则为真；如果 DocumentVisitor 在访问所有节点之前停止操作，则返回 false。调用 DocumentVisitor.VisitSectionStart，然后为该部分的所有子节点调用 Accept，最后调用 DocumentVisitor.VisitSectionEnd。

appendChild(Node newChild)

public Node appendChild(Node newChild)

将指定节点添加到此节点的子节点列表的末尾。

如果 newChild 已经在树中，则首先将其删除。

如果被插入的节点是从另一个文档创建的，你应该使用**M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode)**将节点导入当前文档。然后可以将导入的节点插入到当前文档中。

参数：

范围	类型	描述
newChild	Node	要添加的节点。

退货： Node - 添加的节点。

appendContent(Section sourceSection)

public void appendContent(Section sourceSection)

在此部分末尾插入源部分内容的副本。

仅内容getBody()复制源部分的部分，不复制页面设置、页眉和页脚。

如果源部分属于不同的文档，则会自动导入节点。

目标文档中没有创建新节。

参数：

范围	类型	描述
sourceSection	Section	要从中复制内容的部分。

clearContent()

public void clearContent()

清除该部分。

的文本getBody()被清除后，只留下一个代表分节符的空段落。

所有页眉和页脚的文本被清除，但是HeaderFooter对象本身不会被删除。

clearHeadersFooters()

public void clearHeadersFooters()

清除此部分的页眉和页脚。

所有页眉和页脚的文本被清除，但是HeaderFooter对象本身不会被删除。

这使得本节的页眉和页脚链接到上一节的页眉和页脚。

clearSectionAttrs()

public void clearSectionAttrs()

dd()

public void dd()

deepClone()

public Section deepClone()

创建此部分的副本。

退货： Section

deepClone(boolean isCloneChildren)

public Node deepClone(boolean isCloneChildren)

创建节点的副本。

此方法用作节点的复制构造函数。克隆的节点没有父节点，但与原始节点属于同一个文档。

此方法始终执行节点的深层复制。这isCloneChildren参数指定是否也执行复制所有子节点。

参数：

范围	类型	描述
isCloneChildren	boolean	True 递归克隆指定节点下的子树； false 仅克隆节点本身。

退货： Node - 克隆节点。

deleteHeaderFooterShapes()

public void deleteHeaderFooterShapes()

从该部分的页眉和页脚中删除所有形状（绘图对象）。

ensureMinimum()

public void ensureMinimum()

确保该部分包含一个段落的正文。

equals(Object arg0)

public boolean equals(Object arg0)

参数：

范围	类型	描述
arg0	java.lang.Object

退货： 布尔值

fetchInheritedSectionAttr(int key)

public Object fetchInheritedSectionAttr(int key)

参数：

范围	类型	描述
key	int

退货： java.lang.Object

fetchSectionAttr(int key)

public Object fetchSectionAttr(int key)

参数：

范围	类型	描述
key	int

退货： java.lang.Object

getAncestor(int ancestorType)

public CompositeNode getAncestor(int ancestorType)

参数：

范围	类型	描述
ancestorType	int

退货： CompositeNode

getAncestor(Class ancestorType)

public CompositeNode getAncestor(Class ancestorType)

获取指定对象类型的第一个祖先。

参数：

范围	类型	描述
ancestorType	java.lang.Class	要检索的祖先的对象类型。

退货： CompositeNode - 指定类型的祖先，如果未找到此类型的祖先，则为 null。

如果祖先类型等于 ancestorType 或派生自 ancestorType，则祖先类型匹配。

getBody()

public Body getBody()

返回Body节的子节点。

Body包含该部分的主要文本。

如果该部分没有一个，则返回 nullBody它的孩子之间的节点。

退货： Body - 这Body节的子节点。

getChild(int nodeType, int index, boolean isDeep)

public Node getChild(int nodeType, int index, boolean isDeep)

参数：

范围	类型	描述
nodeType	int
index	int
isDeep	boolean

退货： Node

getChildNodes()

public NodeCollection getChildNodes()

获取此节点的所有直接子节点。

笔记，getChildNodes()相当于调用 GetChildNodes(NodeType.Any, false) 并在每次访问时创建并返回一个新集合。

如果没有子节点，则此属性返回一个空集合。

退货： NodeCollection - 该节点的所有直接子节点。

getChildNodes(int nodeType, boolean isDeep)

public NodeCollection getChildNodes(int nodeType, boolean isDeep)

参数：

范围	类型	描述
nodeType	int
isDeep	boolean

退货： NodeCollection

getClass()

public final native Class<?> getClass()

退货： java.lang.Class

getContainer()

public CompositeNode getContainer()

退货： CompositeNode

getCount()

public int getCount()

获取此节点的直接子节点数。

退货： int - 此节点的直接子节点数。

getCurrentNode()

public Node getCurrentNode()

退货： Node

getCustomNodeId()

public int getCustomNodeId()

指定自定义节点标识符。

默认为零。

这个标识符可以任意设置和使用。例如，作为获取外部数据的密钥。

重要说明，指定的值不会保存到输出文件中，并且仅在节点生命周期内存在。

退货： int - 相应的 int 值。

getDirectSectionAttr(int key)

public Object getDirectSectionAttr(int key)

参数：

范围	类型	描述
key	int

退货： java.lang.Object

getDocument()

public DocumentBase getDocument()

获取此节点所属的文档。

该节点始终属于一个文档，即使它刚刚创建并且尚未添加到树中，或者如果它已从树中删除也是如此。

退货： DocumentBase - 该节点所属的文档。

getFirstChild()

public Node getFirstChild()

获取节点的第一个子节点。如果没有第一个子节点，则返回 null。

退货： Node - 节点的第一个孩子。

getHeadersFooters()

public HeaderFooterCollection getHeadersFooters()

提供对节的页眉和页脚节点的访问。

退货： HeaderFooterCollection - 相应的HeaderFooterCollection价值。

getLastChild()

public Node getLastChild()

获取节点的最后一个子节点。如果没有最后一个子节点，则返回 null。

退货： Node - 节点的最后一个孩子。

getNextMatchingNode(Node curNode)

public Node getNextMatchingNode(Node curNode)

参数：

范围	类型	描述
curNode	Node

退货： Node

getNextSibling()

public Node getNextSibling()

获取紧跟在该节点之后的节点。如果没有下一个节点，则返回 null。

退货： Node - 紧接此节点之后的节点。

getNodeType()

public int getNodeType()

退货NodeType.Section.

退货： 整数 -NodeType.Section .返回值是其中之一NodeType常数。

getPageSetup()

public PageSetup getPageSetup()

返回表示页面设置和部分属性的对象。

退货： PageSetup - 表示页面设置和部分属性的对象。

getParentNode()

public CompositeNode getParentNode()

获取此节点的直接父级。

如果一个节点刚刚被创建并且还没有被添加到树中，或者如果它已经被从树中移除，则父节点为空。

退货： CompositeNode - 此节点的直接父节点。

getPreviousSibling()

public Node getPreviousSibling()

获取紧接在该节点之前的节点。如果前面没有节点，则返回 null。

退货： Node - 紧接在该节点之前的节点。

getProtectedForForms()

public boolean getProtectedForForms()

如果该部分受表单保护，则为真。当某个部分受表单保护时，用户只能在 Microsoft Word 的表单域中选择和修改文本。

退货： boolean - 相应的布尔值。

getRange()

public Range getRange()

返回一个Range表示包含在该节点中的文档部分的对象。

退货： Range - 一个Range表示包含在该节点中的文档部分的对象。

getText()

public String getText()

获取此节点及其所有子节点的文本。

返回的字符串包括所有控制字符和特殊字符，如ControlChar.

退货： java.lang.字符串

hasChildNodes()

public boolean hasChildNodes()

如果此节点有任何子节点，则返回 true。

退货： boolean - 如果此节点有任何子节点则为真。

hashCode()

public native int hashCode()

退货： 整数

indexOf(Node child)

public int indexOf(Node child)

返回子节点数组中指定子节点的索引。如果在子节点中找不到该节点，则返回 -1。

参数：

范围	类型	描述
child	Node

退货： 整数

insertAfter(Node newChild, Node refChild)

public Node insertAfter(Node newChild, Node refChild)

在指定的引用节点之后立即插入指定的节点。

如果 refChild 为 null，则在子节点列表的开头插入 newChild。

如果 newChild 已经在树中，则首先将其删除。

如果被插入的节点是从另一个文档创建的，你应该使用**M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode)**将节点导入当前文档。然后可以将导入的节点插入到当前文档中。

参数：

范围	类型	描述
newChild	Node	要插入的节点。
refChild	Node	作为参考节点的节点。 newNode 放置在 refNode 之后。

退货： Node - 插入的节点。

insertBefore(Node newChild, Node refChild)

public Node insertBefore(Node newChild, Node refChild)

将指定节点插入到紧靠指定引用节点之前。

如果 refChild 为 null，则在子节点列表的末尾插入 newChild。

如果 newChild 已经在树中，则首先将其删除。

如果被插入的节点是从另一个文档创建的，你应该使用**M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode)**将节点导入当前文档。然后可以将导入的节点插入到当前文档中。

参数：

范围	类型	描述
newChild	Node	要插入的节点。
refChild	Node	作为参考节点的节点。 newChild 放置在此节点之前。

退货： Node - 插入的节点。

isComposite()

public boolean isComposite()

返回 true，因为此节点可以有子节点。

退货： boolean - True 因为这个节点可以有子节点。

iterator()

public Iterator iterator()

为该节点的子节点上的每个样式迭代提供支持。

退货： java.util.迭代器

nextPreOrder(Node rootNode)

public Node nextPreOrder(Node rootNode)

根据前序树遍历算法获取下一个节点。

参数：

范围	类型	描述
rootNode	Node	遍历的顶端节点（极限）。

退货： Node - 预定顺序中的下一个节点。如果到达根节点则为空。

nodeTypeToString(int nodeType)

public static String nodeTypeToString(int nodeType)

参数：

范围	类型	描述
nodeType	int

退货： java.lang.字符串

notify()

public final native void notify()

notifyAll()

public final native void notifyAll()

prependChild(Node newChild)

public Node prependChild(Node newChild)

将指定节点添加到此节点的子节点列表的开头。

如果 newChild 已经在树中，则首先将其删除。

如果被插入的节点是从另一个文档创建的，你应该使用**M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode)**将节点导入当前文档。然后可以将导入的节点插入到当前文档中。

参数：

范围	类型	描述
newChild	Node	要添加的节点。

退货： Node - 添加的节点。

prependContent(Section sourceSection)

public void prependContent(Section sourceSection)

在此部分的开头插入源部分内容的副本。

仅内容getBody()复制源部分的部分，不复制页面设置、页眉和页脚。

如果源部分属于不同的文档，则会自动导入节点。

目标文档中没有创建新节。

参数：

范围	类型	描述
sourceSection	Section	要从中复制内容的部分。

previousPreOrder(Node rootNode)

public Node previousPreOrder(Node rootNode)

根据前序树遍历算法获取上一个节点。

参数：

范围	类型	描述
rootNode	Node	遍历的顶端节点（极限）。

退货： Node 预购顺序中的前一个节点。如果到达根节点则为空。

remove()

public void remove()

从父级中移除自身。

removeAllChildren()

public void removeAllChildren()

移除当前节点的所有子节点。

removeChild(Node oldChild)

public Node removeChild(Node oldChild)

删除指定的子节点。

删除节点后，oldChild 的父级设置为 null。

参数：

范围	类型	描述
oldChild	Node	要删除的节点。

退货： Node - 删除的节点。

removeSmartTags()

public void removeSmartTags()

删除所有SmartTag当前节点的后代节点。此方法不会删除智能标记的内容。

selectNodes(String xpath)

public NodeList selectNodes(String xpath)

选择与 XPath 表达式匹配的节点列表。

目前仅支持带有元素名称的表达式。不支持使用属性名称的表达式。

参数：

范围	类型	描述
xpath	java.lang.String	XPath 表达式。

退货： NodeList - 匹配 XPath 查询的节点列表。

selectSingleNode(String xpath)

public Node selectSingleNode(String xpath)

选择与 XPath 表达式匹配的第一个节点。

目前仅支持带有元素名称的表达式。不支持使用属性名称的表达式。

参数：

范围	类型	描述
xpath	java.lang.String	XPath 表达式。

退货： Node - 与 XPath 查询匹配的第一个节点，如果未找到匹配节点，则为 null。

setCustomNodeId(int value)

public void setCustomNodeId(int value)

指定自定义节点标识符。

默认为零。

这个标识符可以任意设置和使用。例如，作为获取外部数据的密钥。

重要说明，指定的值不会保存到输出文件中，并且仅在节点生命周期内存在。

参数：

范围	类型	描述
value	int	对应的int值。

setProtectedForForms(boolean value)

public void setProtectedForForms(boolean value)

如果该部分受表单保护，则为真。当某个部分受表单保护时，用户只能在 Microsoft Word 的表单域中选择和修改文本。

参数：

范围	类型	描述
value	boolean	对应的布尔值。

setSectionAttr(int key, Object value)

public void setSectionAttr(int key, Object value)

参数：

范围	类型	描述
key	int
value	java.lang.Object

toString()

public String toString()

退货： java.lang.字符串

toString(SaveOptions saveOptions)

public String toString(SaveOptions saveOptions)

使用指定的保存选项将节点的内容导出为字符串。

参数：

范围	类型	描述
saveOptions	SaveOptions	指定控制节点保存方式的选项。

退货： java.lang.String - 指定格式的节点内容。

toString(int saveFormat)

public String toString(int saveFormat)

参数：

范围	类型	描述
saveFormat	int

退货： java.lang.字符串

wait()

public final void wait()

wait(long arg0)

public final native void wait(long arg0)

参数：

范围	类型	描述
arg0	long

wait(long arg0, int arg1)

public final void wait(long arg0, int arg1)

参数：

范围	类型	描述
arg0	long
arg1	int