Paragraph

Paragraph class

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

public class Paragraph : CompositeNode

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

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

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

Имя Описание
BreakIsStyleSeparator { get; } Истинно, если этот разрыв абзаца является разделителем стилей. Разделитель стилей позволяет абзацу one состоять из частей с разными стилями абзаца.
ChildNodes { get; } Получает все непосредственные дочерние узлы этого узла.
Count { get; } Получает количество непосредственных дочерних элементов этого узла.
CustomNodeId { get; set; } Указывает идентификатор пользовательского узла.
virtual Document { get; } Получает документ, которому принадлежит этот узел.
FirstChild { get; } Получает первого потомка узла.
FrameFormat { get; } Предоставляет доступ к свойствам форматирования абзаца.
HasChildNodes { get; } Возвращает true, если у этого узла есть дочерние узлы.
override IsComposite { get; } Возвращает true, так как этот узел может иметь дочерние узлы.
IsDeleteRevision { get; } Возвращает значение true, если этот объект был удален в Microsoft Word при включенном отслеживании изменений.
IsEndOfCell { get; } Истинно, если этот абзац является последним абзацем вCell ; false иначе.
IsEndOfDocument { get; } Истинно, если этот абзац является последним абзацем в последнем разделе документа.
IsEndOfHeaderFooter { get; } Истинно, если этот абзац является последним абзацем в Верхний колонтитул (рассказ основного текста) Раздел ; false иначе.
IsEndOfSection { get; } Истинно, если этот абзац является последним абзацем в Тело (рассказ основного текста) Раздел ; false иначе.
IsFormatRevision { get; } Возвращает значение true, если форматирование объекта было изменено в Microsoft Word при включенном отслеживании изменений.
IsInCell { get; } Истинно, если этот абзац является непосредственным потомкомCell ; false иначе.
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; } Возвращает NodeType.Параграф .
ParagraphBreakFont { get; } Предоставляет доступ к форматированию шрифта символа разрыва абзаца.
ParagraphFormat { get; } Предоставляет доступ к свойствам форматирования абзаца.
ParentNode { get; } Получает непосредственного родителя этого узла.
ParentSection { get; } Извлекает родителяSection абзаца.
ParentStory { get; } Извлекает историю на уровне родительского раздела, которую можноBody или жеHeaderFooter .
PreviousSibling { get; } Получает узел, непосредственно предшествующий этому узлу.
Range { get; } Возвращает Диапазон объект, представляющий часть документа, содержащегося в этом узле.
Runs { get; } Предоставляет доступ к набранному набору фрагментов текста внутри абзаца.

Методы

Имя Описание
override Accept(DocumentVisitor) Принимает посетителя.
AppendChild(Node) Добавляет указанный узел в конец списка дочерних узлов для этого узла.
AppendField(string) Добавляет поле к этому абзацу.
AppendField(FieldType, bool) Добавляет поле к этому абзацу.
AppendField(string, string) Добавляет поле к этому абзацу.
Clone(bool) Создает дубликат узла.
CreateNavigator() Зарезервировано для системного использования. IXPathNavigable.
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) Выбирает первый узел, соответствующий выражению XPath.
ToString(SaveFormat) Экспортирует содержимое узла в строку в указанном формате.
ToString(SaveOptions) Экспортирует содержимое узла в строку, используя указанные параметры сохранения.

Примечания

Paragraph является блочным узлом и может быть дочерним по отношению к классам, производным от Story или жеInlineStory.

Paragraph может содержать любое количество встроенных узлов и закладок.

Полный список дочерних узлов, которые могут находиться внутри абзаца, состоит из BookmarkStart ,BookmarkEnd , FieldStart ,FieldSeparator , FieldEnd ,FormField , Comment ,Footnote , Run ,SpecialChar , Shape ,GroupShape , SmartTag.

Действительный абзац в Microsoft Word всегда заканчивается символом разрыва абзаца и минимальный допустимый абзац состоит только из разрыва абзаца. Параграф Класс автоматически добавляет соответствующий символ разрыва абзаца в конец , и этот символ не является частью дочерних узлов класса. Параграф , поэтому a Параграф может быть пустым.

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

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