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; }	Возвращает значение true, если этот объект был удален в Microsoft Word при включенном отслеживании изменений.
IsEndOfCell { get; }	Истина, если этот абзац является последним абзацем вCell ; в противном случае ложно.
IsEndOfDocument { get; }	Истина, если этот абзац является последним абзацем в последнем разделе документа.
IsEndOfHeaderFooter { get; }	Истина, если этот абзац является последним абзацем вHeaderFooter (основной текст рассказа)Section ; в противном случае ложно.
IsEndOfSection { get; }	Истина, если этот абзац является последним абзацем вBody (основной текст рассказа)Section ; в противном случае ложно.
IsFormatRevision { get; }	Возвращает значение true, если форматирование объекта было изменено в Microsoft Word при включенном отслеживании изменений.
IsInCell { get; }	Истина, если этот абзац является непосредственным потомкомCell ; в противном случае ложно.
IsInsertRevision { get; }	Возвращает значение true, если этот объект был вставлен в Microsoft Word при включенном отслеживании изменений.
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 , поэтому аParagraph может быть пустым.

Не включайте конец абзаца.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");

Смотрите также

• class CompositeNode
• пространство имен Aspose.Words
• сборка Aspose.Words