## Section class Represents a single section in a document. To learn more, visit the [Working with Sections](https://docs.aspose.com/words/cpp/working-with-sections/) documentation article. ```cpp class Section : public Aspose::Words::CompositeNode, public ISectionAttrSource ``` ## Methods | Method | Description | | --- | --- | | [Accept](./accept/)(System::SharedPtr\) override | Accepts a visitor. | | [AcceptEnd](./acceptend/)(System::SharedPtr\) override | When implemented in a derived class, calls the VisitXXXEnd method of the specified document visitor. | | [AcceptStart](./acceptstart/)(System::SharedPtr\) override | When implemented in a derived class, calls the VisitXXXStart method of the specified document visitor. | | [AppendChild](../compositenode/appendchild/)(T) | | | [AppendContent](./appendcontent/)(const System::SharedPtr\\&) | Inserts a copy of content of the source section at the end of this section. | | [ClearContent](./clearcontent/)() | Clears the section. | | [ClearHeadersFooters](./clearheadersfooters/)() | Clears the headers and footers of this section. | | [ClearHeadersFooters](./clearheadersfooters/)(bool) | Clears the headers and footers of this section. | | [Clone](./clone/)() | Creates a duplicate of this section. | | [Clone](../node/clone/)(bool) | Creates a duplicate of the node. | | [DeleteHeaderFooterShapes](./deleteheaderfootershapes/)() | Deletes all shapes (drawing objects) from the headers and footers of this section. | | [EnsureMinimum](./ensureminimum/)() | Ensures that the section has [Body](./get_body/) with one [Paragraph](../paragraph/). | | [get_Body](./get_body/)() | Returns the [Body](../body/) child node of the section. | | [get_Count](../compositenode/get_count/)() | Gets the number of immediate children of this node. | | [get_CustomNodeId](../node/get_customnodeid/)() const | Specifies custom node identifier. | | virtual [get_Document](../node/get_document/)() const | Gets the document to which this node belongs. | | [get_FirstChild](../compositenode/get_firstchild/)() const | Gets the first child of the node. | | [get_HasChildNodes](../compositenode/get_haschildnodes/)() | Returns **true** if this node has any child nodes. | | [get_HeadersFooters](./get_headersfooters/)() | Provides access to the headers and footers nodes of the section. | | [get_IsComposite](../compositenode/get_iscomposite/)() override | Returns **true** as this node can have child nodes. | | [get_LastChild](../compositenode/get_lastchild/)() const | Gets the last child of the node. | | [get_NextNode](../node/get_nextnode/)() const | | | [get_NextSibling](../node/get_nextsibling/)() | Gets the node immediately following this node. | | [get_NodeType](./get_nodetype/)() const override | Returns [Section](../nodetype/). | | [get_PageSetup](./get_pagesetup/)() | Returns an object that represents page setup and section properties. | | [get_ParentNode](../node/get_parentnode/)() | Gets the immediate parent of this node. | | [get_PreviousSibling](../node/get_previoussibling/)() | Gets the node immediately preceding this node. | | [get_PrevNode](../node/get_prevnode/)() const | | | [get_ProtectedForForms](./get_protectedforforms/)() | True if the section is protected for forms. When a section is protected for forms, users can select and modify text only in form fields in Microsoft Word. | | [get_Range](../node/get_range/)() | Returns a [Range](../range/) object that represents the portion of a document that is contained in this node. | | [GetAncestor](../node/getancestor/)(Aspose::Words::NodeType) | Gets the first ancestor of the specified [NodeType](../nodetype/). | | [GetAncestorOf](../node/getancestorof/)() | | | [GetChild](../compositenode/getchild/)(Aspose::Words::NodeType, int32_t, bool) | Returns an Nth child node that matches the specified type. | | [GetChildNodes](../compositenode/getchildnodes/)(Aspose::Words::NodeType, bool) | Returns a live collection of child nodes that match the specified type. | | [GetEnumerator](../compositenode/getenumerator/)() override | Provides support for the for each style iteration over the child nodes of this node. | | [GetText](../compositenode/gettext/)() override | Gets the text of this node and of all its children. | | [GetType](./gettype/)() const override | | | [IndexOf](../compositenode/indexof/)(const System::SharedPtr\\&) | Returns the index of the specified child node in the child node array. | | [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\\&) | Gets next node according to the pre-order tree traversal algorithm. | | static [NodeTypeToString](../node/nodetypetostring/)(Aspose::Words::NodeType) | A utility method that converts a node type enum value into a user friendly string. | | [PrependChild](../compositenode/prependchild/)(T) | | | [PrependContent](./prependcontent/)(const System::SharedPtr\\&) | Inserts a copy of content of the source section at the beginning of this section. | | [PreviousPreOrder](../node/previouspreorder/)(const System::SharedPtr\\&) | Gets the previous node according to the pre-order tree traversal algorithm. | | [Remove](../node/remove/)() | Removes itself from the parent. | | [RemoveAllChildren](../compositenode/removeallchildren/)() | Removes all the child nodes of the current node. | | [RemoveChild](../compositenode/removechild/)(T) | | | [RemoveSmartTags](../compositenode/removesmarttags/)() | Removes all [SmartTag](../../aspose.words.markup/smarttag/) descendant nodes of the current node. | | [Section](./section/)(const System::SharedPtr\\&) | Initializes a new instance of the [Section](./) class. | | [SelectNodes](../compositenode/selectnodes/)(const System::String\&) | Selects a list of nodes matching the XPath expression. | | [SelectSingleNode](../compositenode/selectsinglenode/)(const System::String\&) | Selects the first [Node](../node/) that matches the XPath expression. | | [set_CustomNodeId](../node/set_customnodeid/)(int32_t) | Setter for [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) | Setter for [Aspose::Words::Section::get_ProtectedForForms](./get_protectedforforms/). | | [SetParent](../node/setparent/)(const System::SharedPtr\\&) | | | [ToString](../node/tostring/)(Aspose::Words::SaveFormat) | Exports the content of the node into a string in the specified format. | | [ToString](../node/tostring/)(const System::SharedPtr\\&) | Exports the content of the node into a string using the specified save options. | | static [Type](./type/)() | | ## Remarks [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](./). A minimal valid section needs to have [Body](../body/) with one [Paragraph](../paragraph/). Each section has its own set of properties that specify page size, orientation, margins etc. You can create a copy of a section using [Clone()](../node/clone/). The copy can be inserted into the same or different document. To add, insert or remove a whole section including section break and section properties use methods of the [Sections](../document/get_sections/) object. To copy and insert just content of the section excluding the section break and section properties use [AppendContent()](../) and [PrependContent()](../) methods. ## Examples Shows how to construct an Aspose.Words document by hand. ```cpp auto doc = System::MakeObject(); // A blank document contains one section, one body and one paragraph. // Call the "RemoveAllChildren" method to remove all those nodes, // and end up with a document node with no children. doc->RemoveAllChildren(); // This document now has no composite child nodes that we can add content to. // If we wish to edit it, we will need to repopulate its node collection. // First, create a new section, and then append it as a child to the root document node. auto section = System::MakeObject(doc); doc->AppendChild>(section); // Set some page setup properties for the section. section->get_PageSetup()->set_SectionStart(SectionStart::NewPage); section->get_PageSetup()->set_PaperSize(PaperSize::Letter); // A section needs a body, which will contain and display all its contents // on the page between the section's header and footer. auto body = System::MakeObject(doc); section->AppendChild>(body); // Create a paragraph, set some formatting properties, and then append it as a child to the body. auto para = System::MakeObject(doc); para->get_ParagraphFormat()->set_StyleName(u"Heading 1"); para->get_ParagraphFormat()->set_Alignment(ParagraphAlignment::Center); body->AppendChild>(para); // Finally, add some content to do the document. Create a run, // set its appearance and contents, and then append it as a child to the paragraph. 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"); ``` ## See Also * Class [CompositeNode](../compositenode/) * Namespace [Aspose::Words](../) * Library [Aspose.Words for C++](../../)