## Section class Представляет одну секцию в документе. Чтобы узнать больше, посетите статью документации [Working with Sections](https://docs.aspose.com/words/cpp/working-with-sections/). ```cpp class Section : public Aspose::Words::CompositeNode, public Aspose::Words::ISectionAttrSource ``` ## Методы | Метод | Описание | | --- | --- | | [Accept](./accept/)(System::SharedPtr\) override | Принимает посетителя. | | [AcceptEnd](./acceptend/)(System::SharedPtr\) override | Когда реализовано в производном классе, вызывает метод VisitXXXEnd указанного посетителя документа. | | [AcceptStart](./acceptstart/)(System::SharedPtr\) override | Когда реализовано в производном классе, вызывает метод VisitXXXStart указанного посетителя документа. | | [AppendChild](../compositenode/appendchild/)(T) | | | [AppendContent](./appendcontent/)(const System::SharedPtr\\&) | Вставляет копию содержимого исходного раздела в конец этого раздела. | | [ClearContent](./clearcontent/)() | Очищает раздел. | | [ClearHeadersFooters](./clearheadersfooters/)() | Очищает колонтитулы (верхний и нижний) этого раздела. | | [ClearHeadersFooters](./clearheadersfooters/)(bool) | Очищает колонтитулы (верхний и нижний) этого раздела. | | [Clone](./clone/)() | Создаёт дубликат этого раздела. | | [Clone](../node/clone/)(bool) | Создаёт дубликат узла. | | [DeleteHeaderFooterShapes](./deleteheaderfootershapes/)() | Удаляет все фигуры (объекты рисования) из колонтитулов этого раздела. | | [EnsureMinimum](./ensureminimum/)() | Обеспечивает наличие у раздела [Body](./get_body/) с одним [Paragraph](../paragraph/). | | [get_Body](./get_body/)() | Возвращает дочерний узел [Body](../body/) раздела. | | [get_Count](../compositenode/get_count/)() | Возвращает количество непосредственных дочерних элементов этого узла. | | [get_CustomNodeId](../node/get_customnodeid/)() const | Указывает пользовательский идентификатор узла. | | virtual [get_Document](../node/get_document/)() const | Возвращает документ, к которому принадлежит этот узел. | | [get_FirstChild](../compositenode/get_firstchild/)() const | Возвращает первого дочернего узла. | | [get_HasChildNodes](../compositenode/get_haschildnodes/)() | Возвращает **true**, если у этого узла есть дочерние узлы. | | [get_HeadersFooters](./get_headersfooters/)() | Предоставляет доступ к узлам колонтитулов раздела. | | [get_IsComposite](../compositenode/get_iscomposite/)() override | Возвращает **true**, поскольку этот узел может иметь дочерние узлы. | | [get_LastChild](../compositenode/get_lastchild/)() const | Возвращает последнего дочернего узла. | | [get_NextNode](../node/get_nextnode/)() const | | | [get_NextSibling](../node/get_nextsibling/)() | Возвращает узел, непосредственно следующий за этим узлом. | | [get_NodeType](./get_nodetype/)() const override | Возвращает [Section](../nodetype/). | | [get_PageSetup](./get_pagesetup/)() | Возвращает объект, представляющий настройки страницы и свойства раздела. | | [get_ParentNode](../node/get_parentnode/)() | Возвращает непосредственного родителя этого узла. | | [get_PreviousSibling](../node/get_previoussibling/)() | Возвращает узел, непосредственно предшествующий этому узлу. | | [get_PrevNode](../node/get_prevnode/)() const | | | [get_ProtectedForForms](./get_protectedforforms/)() | Истина, если раздел защищён для форм. Когда раздел защищён для форм, пользователи могут выделять и изменять текст только в полях формы в Microsoft Word. | | [get_Range](../node/get_range/)() | Возвращает объект [Range](../range/), представляющий часть документа, содержащуюся в этом узле. | | [GetAncestor](../node/getancestor/)(Aspose::Words::NodeType) | Получает первого предка указанного [NodeType](../nodetype/). | | [GetAncestorOf](../node/getancestorof/)() | | | [GetChild](../compositenode/getchild/)(Aspose::Words::NodeType, int32_t, bool) | Возвращает N‑й дочерний узел, соответствующий указанному типу. | | [GetChildNodes](../compositenode/getchildnodes/)(Aspose::Words::NodeType, bool) | Возвращает живую коллекцию дочерних узлов, соответствующих указанному типу. | | [GetEnumerator](../compositenode/getenumerator/)() override | Обеспечивает поддержку итерации в стиле foreach по дочерним узлам этого узла. | | [GetText](../compositenode/gettext/)() override | Получает текст этого узла и всех его дочерних узлов. | | [GetType](./gettype/)() const override | | | [IndexOf](../compositenode/indexof/)(const System::SharedPtr\\&) | Возвращает индекс указанного дочернего узла в массиве дочерних узлов. | | [InsertAfter](../compositenode/insertafter/)(T, const System::SharedPtr\\&) | | | [InsertBefore](../compositenode/insertbefore/)(T, const System::SharedPtr\\&) | | | [Is](./is/)(const System::TypeInfo\&) const override | | | [IsAncestorNode](../node/isancestornode/)(const System::SharedPtr\\&) | | | [NextPreOrder](../node/nextpreorder/)(const System::SharedPtr\\&) | Получает следующий узел согласно алгоритму обхода дерева в порядке предобхода. | | static [NodeTypeToString](../node/nodetypetostring/)(Aspose::Words::NodeType) | Вспомогательный метод, преобразующий значение перечисления типа узла в удобочитаемую строку. | | [PrependChild](../compositenode/prependchild/)(T) | | | [PrependContent](./prependcontent/)(const System::SharedPtr\\&) | Вставляет копию содержимого исходного раздела в начало этого раздела. | | [PreviousPreOrder](../node/previouspreorder/)(const System::SharedPtr\\&) | Получает предыдущий узел согласно алгоритму обхода дерева в порядке предобхода. | | [Remove](../node/remove/)() | Удаляет себя из родительского узла. | | [RemoveAllChildren](../compositenode/removeallchildren/)() | Удаляет все дочерние узлы текущего узла. | | [RemoveChild](../compositenode/removechild/)(T) | | | [RemoveSmartTags](../compositenode/removesmarttags/)() | Удаляет все дочерние узлы [SmartTag](../../aspose.words.markup/smarttag/) текущего узла. | | [Section](./section/)(const System::SharedPtr\\&) | Инициализирует новый экземпляр класса [Section](./). | | [SelectNodes](../compositenode/selectnodes/)(const System::String\&) | Выбирает список узлов, соответствующих XPath-выражению. | | [SelectSingleNode](../compositenode/selectsinglenode/)(const System::String\&) | Выбирает первый [Node](../node/), который соответствует выражению XPath. | | [set_CustomNodeId](../node/set_customnodeid/)(int32_t) | Сеттер для [Aspose::Words::Node::get_CustomNodeId](../node/get_customnodeid/). | | [set_NextNode](../node/set_nextnode/)(const System::SharedPtr\\&) | | | [set_PrevNode](../node/set_prevnode/)(const System::SharedPtr\\&) | | | [set_ProtectedForForms](./set_protectedforforms/)(bool) | Сеттер для [Aspose::Words::Section::get_ProtectedForForms](./get_protectedforforms/). | | [SetParent](../node/setparent/)(const System::SharedPtr\\&) | | | [SetTemplateWeakPtr](../compositenode/settemplateweakptr/)(uint32_t) override | | | [ToString](../node/tostring/)(Aspose::Words::SaveFormat) | Экспортирует содержимое узла в строку в указанном формате. | | [ToString](../node/tostring/)(const System::SharedPtr\\&) | Экспортирует содержимое узла в строку, используя указанные параметры сохранения. | | static [Type](./type/)() | | ## Примечания [Section](./) can have one [Body](../body/) and maximum one [HeaderFooter](../headerfooter/) of each [HeaderFooterType](../headerfootertype/). [Body](../body/) and [HeaderFooter](../headerfooter/) nodes can be in any order inside [Section](./). Минимальный корректный раздел должен содержать [Body](../body/) с одним [Paragraph](../paragraph/). Каждый раздел имеет собственный набор свойств, определяющих размер страницы, ориентацию, поля и т.д. Вы можете создать копию раздела с помощью [Clone()](../node/clone/). Копию можно вставить в тот же документ или в другой. Чтобы добавить, вставить или удалить целый раздел, включая разрыв раздела и свойства раздела, используйте методы объекта [Sections](../document/get_sections/). Чтобы скопировать и вставить только содержимое раздела без разрыва раздела и его свойств, используйте методы [AppendContent()](../) и [PrependContent()](../). ## Примеры Показывает, как вручную построить документ Aspose.Words. ```cpp auto doc = System::MakeObject(); // Пустой документ содержит один раздел, одно тело и один абзац. // Вызовите метод "RemoveAllChildren", чтобы удалить все эти узлы, // и в результате получите узел документа без дочерних элементов. doc->RemoveAllChildren(); // У этого документа теперь нет составных дочерних узлов, к которым мы могли бы добавить содержимое. // Если мы захотим отредактировать его, нам потребуется заново заполнить его коллекцию узлов. // Сначала создайте новый раздел, а затем добавьте его как дочерний элемент к корневому узлу документа. auto section = System::MakeObject(doc); doc->AppendChild>(section); // Установите некоторые свойства разметки страницы для раздела. section->get_PageSetup()->set_SectionStart(Aspose::Words::SectionStart::NewPage); section->get_PageSetup()->set_PaperSize(Aspose::Words::PaperSize::Letter); // Разделу требуется тело, которое будет содержать и отображать всё его содержимое // на странице между заголовком и нижним колонтитулом раздела. auto body = System::MakeObject(doc); section->AppendChild>(body); // Создайте абзац, задайте некоторые свойства форматирования и затем добавьте его как дочерний элемент к телу. auto para = System::MakeObject(doc); para->get_ParagraphFormat()->set_StyleName(u"Heading 1"); para->get_ParagraphFormat()->set_Alignment(Aspose::Words::ParagraphAlignment::Center); body->AppendChild>(para); // Наконец, добавьте некоторое содержимое в документ. Создайте объект Run, // задайте его внешний вид и содержимое, а затем добавьте его как дочерний элемент к абзацу. auto run = System::MakeObject(doc); run->set_Text(u"Hello World!"); run->get_Font()->set_Color(System::Drawing::Color::get_Red()); para->AppendChild>(run); ASSERT_EQ(u"Hello World!", doc->GetText().Trim()); doc->Save(get_ArtifactsDir() + u"Section.CreateManually.docx"); ``` ## См. также * Class [CompositeNode](../compositenode/) * Namespace [Aspose::Words](../) * Library [Aspose.Words for C++](../../)