Aspose::Words::Paragraph класс

Paragraph class

Представляет абзац текста. Чтобы узнать больше, посетите статью документации Working with Paragraphs.

class Paragraph : public Aspose::Words::CompositeNode,
                  public Aspose::Words::IParaAttrSource,
                  public Aspose::Words::IRunAttrSource,
                  public Aspose::Words::Revisions::ITrackableNode

Методы

Метод	Описание
Accept(System::SharedPtr<Aspose::Words::DocumentVisitor>) override	Принимает посетителя.
AcceptEnd(System::SharedPtr<Aspose::Words::DocumentVisitor>) override	Принимает посетителя для посещения конца абзаца документа.
AcceptStart(System::SharedPtr<Aspose::Words::DocumentVisitor>) override	Принимает посетителя для посещения начала абзаца документа.
AppendChild(T)
AppendField(Aspose::Words::Fields::FieldType, bool)	Добавляет поле к этому абзацу.
AppendField(const System::String&)	Добавляет поле к этому абзацу.
AppendField(const System::String&, const System::String&)	Добавляет поле к этому абзацу.
Clone(bool)	Создаёт дубликат узла.
get_BreakIsStyleSeparator()	Истина, если разрыв этого абзаца является разделителем Style. Разделитель стиля позволяет одному абзацу состоять из частей, имеющих разные стили абзаца.
get_Count()	Возвращает количество непосредственных дочерних элементов этого узла.
get_CustomNodeId() const	Указывает пользовательский идентификатор узла.
virtual get_Document() const	Возвращает документ, к которому принадлежит этот узел.
get_FirstChild() const	Возвращает первого дочернего узла.
get_FrameFormat()	Предоставляет доступ к свойствам форматирования рамки.
get_HasChildNodes()	Возвращает true, если у этого узла есть дочерние узлы.
get_IsComposite() override	Возвращает true, поскольку этот узел может иметь дочерние узлы.
get_IsDeleteRevision()	Возвращает true, если этот объект был удалён в Microsoft Word при включённом отслеживании изменений.
get_IsEndOfCell()	Истина, если этот абзац является последним абзацем в Cell; иначе — ложь.
get_IsEndOfDocument()	Истина, если этот абзац является последним абзацем в последнем разделе документа.
get_IsEndOfHeaderFooter()	Истина, если этот абзац является последним абзацем в HeaderFooter (основная текстовая история) Section; иначе — ложь.
get_IsEndOfSection()	Истина, если этот абзац является последним абзацем в Body (основная текстовая история) Section; иначе — ложь.
get_IsFormatRevision()	Возвращает true, если форматирование объекта было изменено в Microsoft Word при включённом отслеживании изменений.
get_IsInCell()	Истина, если этот абзац является непосредственным дочерним элементом Cell; иначе — ложь.
get_IsInsertRevision()	Возвращает true, если этот объект был вставлен в Microsoft Word при включённом отслеживании изменений.
get_IsListItem()	Истина, когда абзац является элементом маркированного или нумерованного списка в оригинальной редакции.
get_IsMoveFromRevision()	Возвращает true, если этот объект был перемещён (удалён) в Microsoft Word при включённом отслеживании изменений.
get_IsMoveToRevision()	Возвращает true, если этот объект был перемещён (вставлен) в Microsoft Word при включённом отслеживании изменений.
get_LastChild() const	Возвращает последнего дочернего узла.
get_ListFormat()	Предоставляет доступ к свойствам форматирования списка абзаца.
get_ListLabel()	Получает объект ListLabel, который предоставляет доступ к значению нумерации списка и его форматированию для этого абзаца.
get_NextNode() const
get_NextSibling()	Возвращает узел, непосредственно следующий за этим узлом.
get_NodeType() const override	Возвращает Paragraph.
get_ParagraphBreakFont()	Предоставляет доступ к форматированию шрифта символа разрыва абзаца.
get_ParagraphFormat()	Предоставляет доступ к свойствам форматирования абзаца.
get_ParentNode()	Возвращает непосредственного родителя этого узла.
get_ParentSection()	Получает родительский Section абзаца.
get_ParentStory()	Получает родительскую историю уровня раздела, которой может быть Body или HeaderFooter.
get_PreviousSibling()	Возвращает узел, непосредственно предшествующий этому узлу.
get_PrevNode() const
get_Range()	Возвращает объект Range, представляющий часть документа, содержащуюся в этом узле.
get_Runs()	Предоставляет доступ к типизированной коллекции фрагментов текста внутри абзаца.
GetAncestor(Aspose::Words::NodeType)	Получает первого предка указанного NodeType.
GetAncestorOf()
GetChild(Aspose::Words::NodeType, int32_t, bool)	Возвращает N‑й дочерний узел, соответствующий указанному типу.
GetChildNodes(Aspose::Words::NodeType, bool)	Возвращает живую коллекцию дочерних узлов, соответствующих указанному типу.
GetEffectiveTabStops()	Возвращает массив всех табуляций, применённых к этому абзацу, включая косвенно применённые стилями или списками.
GetEnumerator() override	Обеспечивает поддержку итерации в стиле foreach по дочерним узлам этого узла.
GetText() override	Получает текст этого абзаца, включая символ конца абзаца.
GetType() const override
IndexOf(const System::SharedPtr<Aspose::Words::Node>&)	Возвращает индекс указанного дочернего узла в массиве дочерних узлов.
InsertAfter(T, const System::SharedPtr<Aspose::Words::Node>&)
InsertBefore(T, const System::SharedPtr<Aspose::Words::Node>&)
InsertField(Aspose::Words::Fields::FieldType, bool, const System::SharedPtr<Aspose::Words::Node>&, bool)	Вставляет поле в этот абзац.
InsertField(const System::String&, const System::SharedPtr<Aspose::Words::Node>&, bool)	Вставляет поле в этот абзац.
InsertField(const System::String&, const System::String&, const System::SharedPtr<Aspose::Words::Node>&, bool)	Вставляет поле в этот абзац.
Is(const System::TypeInfo&) const override
IsAncestorNode(const System::SharedPtr<Aspose::Words::Node>&)
JoinRunsWithSameFormatting()	Объединяет участки текста с одинаковым форматированием в абзаце.
JoinRunsWithSameFormatting(const System::SharedPtr<Aspose::Words::JoinRunsOptions>&)	Объединяет участки текста с одинаковым форматированием в абзаце.
NextPreOrder(const System::SharedPtr<Aspose::Words::Node>&)	Получает следующий узел согласно алгоритму обхода дерева в порядке предобхода.
static NodeTypeToString(Aspose::Words::NodeType)	Вспомогательный метод, преобразующий значение перечисления типа узла в удобочитаемую строку.
Paragraph(const System::SharedPtr<Aspose::Words::DocumentBase>&)	Инициализирует новый экземпляр класса Paragraph.
PrependChild(T)
PreviousPreOrder(const System::SharedPtr<Aspose::Words::Node>&)	Получает предыдущий узел согласно алгоритму обхода дерева в порядке предобхода.
Remove()	Удаляет себя из родительского узла.
RemoveAllChildren()	Удаляет все дочерние узлы текущего узла.
RemoveChild(T)
RemoveSmartTags()	Удаляет все дочерние узлы SmartTag текущего узла.
SelectNodes(const System::String&)	Выбирает список узлов, соответствующих XPath-выражению.
SelectSingleNode(const System::String&)	Выбирает первый Node, который соответствует выражению XPath.
set_CustomNodeId(int32_t)	Сеттер для Aspose::Words::Node::get_CustomNodeId.
set_NextNode(const System::SharedPtr<Aspose::Words::Node>&)
set_PrevNode(const System::SharedPtr<Aspose::Words::Node>&)
SetParent(const System::SharedPtr<Aspose::Words::Node>&)
SetTemplateWeakPtr(uint32_t) override
ToString(Aspose::Words::SaveFormat)	Экспортирует содержимое узла в строку в указанном формате.
ToString(const System::SharedPtr<Aspose::Words::Saving::SaveOptions>&)	Экспортирует содержимое узла в строку, используя указанные параметры сохранения.
static Type()

Примечания

Paragraph is a block-level node and can be a child of classes derived from Story or InlineStory.

Paragraph can contain any number of inline-level nodes and bookmarks.

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

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

Не включайте символы конца абзаца ParagraphBreak или конца ячейки Cell в текст абзаца, так как это может сделать абзац недействительным при открытии документа в Microsoft Word.

Примеры

Показывает, как вручную построить документ Aspose.Words.

auto doc = System::MakeObject<Aspose::Words::Document>();

// Пустой документ содержит один раздел, одно тело и один абзац.
// Вызовите метод "RemoveAllChildren", чтобы удалить все эти узлы,
// и в результате получите узел документа без дочерних элементов.
doc->RemoveAllChildren();

// У этого документа теперь нет составных дочерних узлов, к которым мы могли бы добавить содержимое.
// Если мы захотим отредактировать его, нам потребуется заново заполнить его коллекцию узлов.
// Сначала создайте новый раздел, а затем добавьте его как дочерний элемент к корневому узлу документа.
auto section = System::MakeObject<Aspose::Words::Section>(doc);
doc->AppendChild<System::SharedPtr<Aspose::Words::Section>>(section);

// Установите некоторые свойства разметки страницы для раздела.
section->get_PageSetup()->set_SectionStart(Aspose::Words::SectionStart::NewPage);
section->get_PageSetup()->set_PaperSize(Aspose::Words::PaperSize::Letter);

// Разделу требуется тело, которое будет содержать и отображать всё его содержимое
// на странице между заголовком и нижним колонтитулом раздела.
auto body = System::MakeObject<Aspose::Words::Body>(doc);
section->AppendChild<System::SharedPtr<Aspose::Words::Body>>(body);

// Создайте абзац, задайте некоторые свойства форматирования и затем добавьте его как дочерний элемент к телу.
auto para = System::MakeObject<Aspose::Words::Paragraph>(doc);

para->get_ParagraphFormat()->set_StyleName(u"Heading 1");
para->get_ParagraphFormat()->set_Alignment(Aspose::Words::ParagraphAlignment::Center);

body->AppendChild<System::SharedPtr<Aspose::Words::Paragraph>>(para);

// Наконец, добавьте некоторое содержимое в документ. Создайте объект Run,
// задайте его внешний вид и содержимое, а затем добавьте его как дочерний элемент к абзацу.
auto run = System::MakeObject<Aspose::Words::Run>(doc);
run->set_Text(u"Hello World!");
run->get_Font()->set_Color(System::Drawing::Color::get_Red());
para->AppendChild<System::SharedPtr<Aspose::Words::Run>>(run);

ASSERT_EQ(u"Hello World!", doc->GetText().Trim());

doc->Save(get_ArtifactsDir() + u"Section.CreateManually.docx");

См. также

Класс Aspose::Words::PageSetup Класс Aspose::Words::ParagraphCollection