Paragraph

Paragraph class

代表一段文字。

要了解更多信息，请访问使用段落文档文章。

public class Paragraph : CompositeNode

构造函数

姓名描述
Paragraph(DocumentBase)初始化Paragraph类.

特性

姓名描述
BreakIsStyleSeparator { get; }如果此段落分隔符是样式分隔符，则为 True。样式分隔符允许一个 段落由具有不同段落样式的部分组成。
Count { get; }获取此节点的直属子节点的数量。
CustomNodeId { get; set; }指定自定义节点标识符。
virtual Document { get; }获取此节点所属的文档。
FirstChild { get; }获取节点的第一个子节点。
FrameFormat { get; }提供对框架格式属性的访问。
HasChildNodes { get; }返回真的如果此节点有任何子节点。
override IsComposite { get; }返回真的因为这个节点可以有子节点。
IsDeleteRevision { get; }如果在启用更改跟踪的情况下在 Microsoft Word 中删除了此对象，则返回 true。
IsEndOfCell { get; }如果此段是Cell ；否则为假。
IsEndOfDocument { get; }如果此段是文档最后一节的最后一段，则为真。
IsEndOfHeaderFooter { get; }如果此段是段落的最后一段，则为 TrueHeaderFooter （正文故事）Section ；否则为假。
IsEndOfSection { get; }如果此段是段落的最后一段，则为 TrueBody （正文故事）Section ；否则为假。
IsFormatRevision { get; }如果在启用更改跟踪的情况下 Microsoft Word 中的对象格式发生更改，则返回 true。
IsInCell { get; }如果此段落是其直接子段落，则为 TrueCell ；否则为假。
IsInsertRevision { get; }如果在启用更改跟踪的情况下将此对象插入 Microsoft Word，则返回 true。
IsListItem { get; }当段落是原始修订中的项目符号或编号列表中的项目时，为真。
IsMoveFromRevision { get; }返回真的如果在启用更改跟踪的情况下在 Microsoft Word 中移动（删除）此对象。
IsMoveToRevision { get; }返回真的如果在启用更改跟踪的情况下在 Microsoft Word 中移动（插入）此对象。
LastChild { get; }获取节点的最后一个子节点。
ListFormat { get; }提供对段落列表格式属性的访问。
ListLabel { get; }获得ListLabel提供对列表编号值和此段落的格式 的访问的对象。
NextSibling { get; }获取紧随此节点之后的节点。
override NodeType { get; }返回Paragraph.
ParagraphBreakFont { get; }提供对段落分隔符的字体格式的访问。
ParagraphFormat { get; }提供对段落格式属性的访问。
ParentNode { get; }获取此节点的直接父节点。
ParentSection { get; }检索父级Section段落。
ParentStory { get; }检索可Body或者HeaderFooter.
PreviousSibling { get; }获取此节点前一个节点。
Range { get; }返回Range表示此节点中包含的文档部分的对象。
Runs { get; }提供对段落内文本片段的键入集合的访问。

方法

姓名描述
override Accept(DocumentVisitor)接受访客。
override AcceptEnd(DocumentVisitor)接受访问者访问文档段落的末尾。
override AcceptStart(DocumentVisitor)接受访问者访问文档段落的开头。
AppendChild<T>(T)将指定节点添加到此节点的子节点列表的末尾。
AppendField(string)将字段附加到此段落。
AppendField(FieldType, bool)将字段附加到此段落。
AppendField(string, string)将字段附加到此段落。
Clone(bool)创建节点的副本。
CreateNavigator()创建可用于遍历和读取节点的导航器。
GetAncestor(NodeType)获取指定的第一个祖先NodeType.
GetAncestor(Type)获取指定对象类型的第一个祖先。
GetChild(NodeType, int, bool)返回与指定类型匹配的第 N 个子节点。
GetChildNodes(NodeType, bool)返回与指定类型匹配的子节点的实时集合。
GetEffectiveTabStops()返回应用于此段落的所有制表位数组，包括通过样式或列表间接应用的制表位。
GetEnumerator()为该节点的子节点提供对每个样式迭代的支持。
override GetText()获取此段落的文本（包括段落结束字符）。
IndexOf(Node)返回子节点数组中指定子节点的索引。
InsertAfter<T>(T, Node)在指定的参考节点后立即插入指定的节点。
InsertBefore<T>(T, Node)在指定的参考节点之前立即插入指定的节点。
InsertField(string, Node, bool)在此段落中插入一个字段。
InsertField(FieldType, bool, Node, bool)在此段落中插入一个字段。
InsertField(string, string, Node, bool)在此段落中插入一个字段。
JoinRunsWithSameFormatting()连接段落中具有相同格式的运行。
NextPreOrder(Node)根据前序树遍历算法获取下一个节点。
PrependChild<T>(T)将指定节点添加到此节点的子节点列表的开头。
PreviousPreOrder(Node)根据前序树遍历算法获取前一个节点。
Remove()将自身从父级中移除。
RemoveAllChildren()删除当前节点的所有子节点。
RemoveChild<T>(T)删除指定的子节点。
RemoveSmartTags()删除所有SmartTag当前节点的后代节点。
SelectNodes(string)选择与 XPath 表达式匹配的节点列表。
SelectSingleNode(string)选择第一个Node与 XPath 表达式匹配。
ToString(SaveFormat)将节点的内容导出为指定格式的字符串。
ToString(SaveOptions)使用指定的保存选项将节点内容导出为字符串。

评论

Paragraph是块级节点，可以是派生自 的类的子类Story或者InlineStory。

Paragraph可以包含任意数量的内联级节点和书签。

段落内可出现的子节点的完整列表包括 BookmarkStart，BookmarkEnd, FieldStart，FieldSeparator, FieldEnd，FormField, Comment，Footnote, Run，SpecialChar, Shape，GroupShape, SmartTag。

Microsoft Word 中的有效段落始终以段落分隔符结尾，并且 最小有效段落仅由段落分隔符组成。Paragraph 类会自动在末尾添加适当的段落分隔符 ，并且该字符不是Paragraph，因此 aParagraph可以为空。

不包括段落结尾ParagraphBreak 或单元格结尾Cell段落文本中的字符，因为当在 Microsoft Word 中打开文档时，它可能会使段落无效。

例子

展示如何手动构建 Aspose.Words 文档。

Document doc = new Document();

// 一个空白文档包含一个部分、一个正文和一个段落。
// 调用“RemoveAllChildren”方法删除所有节点，
// 并最终得到一个没有子节点的文档节点。
doc.RemoveAllChildren();

// 此文档现在没有可以添加内容的复合子节点。
// 如果我们想要编辑它，我们将需要重新填充它的节点集合。
// 首先，创建一个新的部分，然后将其作为子节点附加到根文档节点。
Section section = new Section(doc);
doc.AppendChild(section);

// 为该部分设置一些页面设置属性。
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// 一个部分需要一个主体，它将包含并显示其所有内容
// 位于页面部分页眉和页脚之间。
Body body = new Body(doc);
section.AppendChild(body);

// 创建一个段落，设置一些格式属性，然后将其作为子部分附加到正文中。
Paragraph para = new Paragraph(doc);

para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;

body.AppendChild(para);

// 最后，添加一些内容来执行文档。创建一个运行，
// 设置其外观和内容，然后将其作为子项附加到段落。
Run run = new Run(doc);
run.Text = "Hello World!";
run.Font.Color = Color.Red;
para.AppendChild(run);

Assert.AreEqual("Hello World!", doc.GetText().Trim());

doc.Save(ArtifactsDir + "Section.CreateManually.docx");

也可以看看

PaperSize Enum ParagraphAlignment Enum