## CompositeNode class Base class for nodes that can contain other nodes. To learn more, visit the [Aspose.Words Document Object Model (DOM)](https://docs.aspose.com/words/cpp/aspose-words-document-object-model/) documentation article. ```cpp class CompositeNode : public Aspose::Words::Node, public System::Collections::Generic::IEnumerable>, public INodeCollection ``` ## Methods | Method | Description | | --- | --- | | virtual [Accept](../node/accept/)(System::SharedPtr\) | Accepts a visitor. | | virtual [AcceptEnd](./acceptend/)(System::SharedPtr\) | When implemented in a derived class, calls the VisitXXXEnd method of the specified document visitor. | | virtual [AcceptStart](./acceptstart/)(System::SharedPtr\) | When implemented in a derived class, calls the VisitXXXStart method of the specified document visitor. | | [AppendChild](./appendchild/)(T) | | | [Clone](../node/clone/)(bool) | Creates a duplicate of the node. | | [get_Count](./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](./get_firstchild/)() const | Gets the first child of the node. | | [get_HasChildNodes](./get_haschildnodes/)() | Returns **true** if this node has any child nodes. | | [get_IsComposite](./get_iscomposite/)() override | Returns **true** as this node can have child nodes. | | [get_LastChild](./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. | | virtual [get_NodeType](../node/get_nodetype/)() const | Gets the type of this node. | | [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_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](./getchild/)(Aspose::Words::NodeType, int32_t, bool) | Returns an Nth child node that matches the specified type. | | [GetChildNodes](./getchildnodes/)(Aspose::Words::NodeType, bool) | Returns a live collection of child nodes that match the specified type. | | [GetEnumerator](./getenumerator/)() override | Provides support for the for each style iteration over the child nodes of this node. | | [GetText](./gettext/)() override | Gets the text of this node and of all its children. | | [GetType](./gettype/)() const override | | | [IndexOf](./indexof/)(const System::SharedPtr\\&) | Returns the index of the specified child node in the child node array. | | [InsertAfter](./insertafter/)(T, const System::SharedPtr\\&) | | | [InsertBefore](./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](./prependchild/)(T) | | | [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](./removeallchildren/)() | Removes all the child nodes of the current node. | | [RemoveChild](./removechild/)(T) | | | [RemoveSmartTags](./removesmarttags/)() | Removes all [SmartTag](../../aspose.words.markup/smarttag/) descendant nodes of the current node. | | [SelectNodes](./selectnodes/)(const System::String\&) | Selects a list of nodes matching the XPath expression. | | [SelectSingleNode](./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\\&) | | | [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 A document is represented as a tree of nodes, similar to DOM or XmlDocument. For more info see the Composite design pattern. The [CompositeNode](./) class: * Provides access to the child nodes. * Implements Composite operations such as insert and remove children. * Provides methods for XPath navigation. ## Examples Shows how to traverse through a composite node's collection of child nodes. ```cpp auto doc = System::MakeObject(); // Add two runs and one shape as child nodes to the first paragraph of this document. auto paragraph = System::ExplicitCast(doc->GetChild(NodeType::Paragraph, 0, true)); paragraph->AppendChild>(System::MakeObject(doc, u"Hello world! ")); auto shape = System::MakeObject(doc, ShapeType::Rectangle); shape->set_Width(200); shape->set_Height(200); // Note that the 'CustomNodeId' is not saved to an output file and exists only during the node lifetime. shape->set_CustomNodeId(100); shape->set_WrapType(WrapType::Inline); paragraph->AppendChild>(shape); paragraph->AppendChild>(System::MakeObject(doc, u"Hello again!")); // Iterate through the paragraph's collection of immediate children, // and print any runs or shapes that we find within. System::SharedPtr children = paragraph->GetChildNodes(NodeType::Any, false); ASSERT_EQ(3, paragraph->GetChildNodes(NodeType::Any, false)->get_Count()); for (auto&& child : System::IterateOver(children)) { switch (child->get_NodeType()) { case NodeType::Run: std::cout << "Run contents:" << std::endl; std::cout << System::String::Format(u"\t\"{0}\"", child->GetText().Trim()) << std::endl; break; case NodeType::Shape: { auto childShape = System::ExplicitCast(child); std::cout << "Shape:" << std::endl; std::cout << System::String::Format(u"\t{0}, {1}x{2}", childShape->get_ShapeType(), childShape->get_Width(), childShape->get_Height()) << std::endl; ASSERT_EQ(100, shape->get_CustomNodeId()); break; } default: break; } } ``` ## See Also * Class [Node](../node/) * Namespace [Aspose::Words](../) * Library [Aspose.Words for C++](../../)