Paragraph

Paragraph class

Представляет абзац текста.

Чтобы узнать больше, посетитеРабота с абзацами статья документации.

public class Paragraph : CompositeNode

Конструкторы

Имя	Описание
Paragraph(DocumentBase)	Инициализирует новый экземпляр`Paragraph` класс.

Характеристики

Имя	Описание
BreakIsStyleSeparator { get; }	True, если этот разрыв абзаца является разделителем стилей. Разделитель стилей позволяет абзацу one состоять из частей, имеющих разные стили абзаца.
Count { get; }	Получает количество непосредственных дочерних элементов этого узла.
CustomNodeId { get; set; }	Указывает пользовательский идентификатор узла.
virtual Document { get; }	Получает документ, которому принадлежит этот узел.
FirstChild { get; }	Получает первого дочернего элемента узла.
FrameFormat { get; }	Обеспечивает доступ к свойствам форматирования фрейма.
HasChildNodes { get; }	Возвращает`истинный` если у этого узла есть дочерние узлы.
override IsComposite { get; }	Возвращает`истинный` поскольку этот узел может иметь дочерние узлы.
IsDeleteRevision { get; }	Возвращает true, если этот объект был удален в Microsoft Word при включенном отслеживании изменений.
IsEndOfCell { get; }	True, если этот абзац является последним абзацем в`Cell` ; ложь в противном случае.
IsEndOfDocument { get; }	True, если этот абзац является последним абзацем в последнем разделе документа.
IsEndOfHeaderFooter { get; }	True, если этот абзац является последним абзацем в`HeaderFooter` (основной текстовый рассказ)`Section` ; ложь в противном случае.
IsEndOfSection { get; }	True, если этот абзац является последним абзацем в`Body` (основной текстовый рассказ)`Section` ; ложь в противном случае.
IsFormatRevision { get; }	Возвращает true, если форматирование объекта было изменено в Microsoft Word при включенном отслеживании изменений.
IsInCell { get; }	True, если этот абзац является непосредственным дочерним элементом`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)	Принимает посетителя.
AppendChild(Node)	Добавляет указанный узел в конец списка дочерних узлов для этого узла.
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(Node, Node)	Вставляет указанный узел сразу после указанного ссылочного узла.
InsertBefore(Node, Node)	Вставляет указанный узел непосредственно перед указанным ссылочным узлом.
InsertField(string, Node, bool)	Вставляет поле в этот абзац.
InsertField(FieldType, bool, Node, bool)	Вставляет поле в этот абзац.
InsertField(string, string, Node, bool)	Вставляет поле в этот абзац.
JoinRunsWithSameFormatting()	Объединяет прогоны с тем же форматированием в абзаце.
NextPreOrder(Node)	Получает следующий узел в соответствии с алгоритмом обхода дерева предварительного заказа.
PrependChild(Node)	Добавляет указанный узел в начало списка дочерних узлов для этого узла.
PreviousPreOrder(Node)	Получает предыдущий узел в соответствии с алгоритмом обхода дерева предварительного заказа.
Remove()	Удаляет себя от родителя.
RemoveAllChildren()	Удаляет все дочерние узлы текущего узла.
RemoveChild(Node)	Удаляет указанный дочерний узел.
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

PaperSize Enum ParagraphAlignment Enum