## CompositeNode class Базовый класс для узлов, которые могут содержать другие узлы. Чтобы узнать больше, посетите статью документации [Aspose.Words Document Object Model (DOM)](https://docs.aspose.com/words/cpp/aspose-words-document-object-model/). ```cpp class CompositeNode : public Aspose::Words::Node, public System::Collections::Generic::IEnumerable>, public Aspose::Words::INodeCollection ``` ## Методы | Метод | Описание | | --- | --- | | virtual [Accept](../node/accept/)(System::SharedPtr\) | Принимает посетителя. | | virtual [AcceptEnd](./acceptend/)(System::SharedPtr\) | Когда реализовано в производном классе, вызывает метод VisitXXXEnd указанного посетителя документа. | | virtual [AcceptStart](./acceptstart/)(System::SharedPtr\) | Когда реализовано в производном классе, вызывает метод VisitXXXStart указанного посетителя документа. | | [AppendChild](./appendchild/)(T) | | | [Clone](../node/clone/)(bool) | Создаёт дубликат узла. | | [get_Count](./get_count/)() | Возвращает количество непосредственных дочерних элементов этого узла. | | [get_CustomNodeId](../node/get_customnodeid/)() const | Указывает пользовательский идентификатор узла. | | virtual [get_Document](../node/get_document/)() const | Возвращает документ, к которому принадлежит этот узел. | | [get_FirstChild](./get_firstchild/)() const | Возвращает первого дочернего узла. | | [get_HasChildNodes](./get_haschildnodes/)() | Возвращает **true**, если у этого узла есть дочерние узлы. | | [get_IsComposite](./get_iscomposite/)() override | Возвращает **true**, поскольку этот узел может иметь дочерние узлы. | | [get_LastChild](./get_lastchild/)() const | Возвращает последнего дочернего узла. | | [get_NextNode](../node/get_nextnode/)() const | | | [get_NextSibling](../node/get_nextsibling/)() | Возвращает узел, непосредственно следующий за этим узлом. | | virtual [get_NodeType](../node/get_nodetype/)() const | Возвращает тип этого узла. | | [get_ParentNode](../node/get_parentnode/)() | Возвращает непосредственного родителя этого узла. | | [get_PreviousSibling](../node/get_previoussibling/)() | Возвращает узел, непосредственно предшествующий этому узлу. | | [get_PrevNode](../node/get_prevnode/)() const | | | [get_Range](../node/get_range/)() | Возвращает объект [Range](../range/), представляющий часть документа, содержащуюся в этом узле. | | [GetAncestor](../node/getancestor/)(Aspose::Words::NodeType) | Получает первого предка указанного [NodeType](../nodetype/). | | [GetAncestorOf](../node/getancestorof/)() | | | [GetChild](./getchild/)(Aspose::Words::NodeType, int32_t, bool) | Возвращает N‑й дочерний узел, соответствующий указанному типу. | | [GetChildNodes](./getchildnodes/)(Aspose::Words::NodeType, bool) | Возвращает живую коллекцию дочерних узлов, соответствующих указанному типу. | | [GetEnumerator](./getenumerator/)() override | Обеспечивает поддержку итерации в стиле foreach по дочерним узлам этого узла. | | [GetText](./gettext/)() override | Получает текст этого узла и всех его дочерних узлов. | | [GetType](./gettype/)() const override | | | [IndexOf](./indexof/)(const System::SharedPtr\\&) | Возвращает индекс указанного дочернего узла в массиве дочерних узлов. | | [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\\&) | Получает следующий узел согласно алгоритму обхода дерева в порядке предобхода. | | static [NodeTypeToString](../node/nodetypetostring/)(Aspose::Words::NodeType) | Вспомогательный метод, преобразующий значение перечисления типа узла в удобочитаемую строку. | | [PrependChild](./prependchild/)(T) | | | [PreviousPreOrder](../node/previouspreorder/)(const System::SharedPtr\\&) | Получает предыдущий узел согласно алгоритму обхода дерева в порядке предобхода. | | [Remove](../node/remove/)() | Удаляет себя из родительского узла. | | [RemoveAllChildren](./removeallchildren/)() | Удаляет все дочерние узлы текущего узла. | | [RemoveChild](./removechild/)(T) | | | [RemoveSmartTags](./removesmarttags/)() | Удаляет все дочерние узлы [SmartTag](../../aspose.words.markup/smarttag/) текущего узла. | | [SelectNodes](./selectnodes/)(const System::String\&) | Выбирает список узлов, соответствующих XPath-выражению. | | [SelectSingleNode](./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\\&) | | | [SetParent](../node/setparent/)(const System::SharedPtr\\&) | | | [SetTemplateWeakPtr](./settemplateweakptr/)(uint32_t) override | | | [ToString](../node/tostring/)(Aspose::Words::SaveFormat) | Экспортирует содержимое узла в строку в указанном формате. | | [ToString](../node/tostring/)(const System::SharedPtr\\&) | Экспортирует содержимое узла в строку, используя указанные параметры сохранения. | | static [Type](./type/)() | | ## Примечания Документ представляется в виде дерева узлов, похожего на DOM или XmlDocument. Для получения дополнительной информации см. шаблон проектирования Composite. Класс [CompositeNode](./): * Provides access to the child nodes. * Implements Composite operations such as insert and remove children. * Provides methods for XPath navigation. ## Примеры Показывает, как пройтись по коллекции дочерних узлов составного узла. ```cpp auto doc = System::MakeObject(); // Добавьте два фрагмента текста и одну фигуру в качестве дочерних узлов к первому абзацу этого документа. auto paragraph = System::ExplicitCast(doc->GetChild(Aspose::Words::NodeType::Paragraph, 0, true)); paragraph->AppendChild>(System::MakeObject(doc, u"Hello world! ")); auto shape = System::MakeObject(doc, Aspose::Words::Drawing::ShapeType::Rectangle); shape->set_Width(200); shape->set_Height(200); // Обратите внимание, что 'CustomNodeId' не сохраняется в выходной файл и существует только в течение жизни узла. shape->set_CustomNodeId(100); shape->set_WrapType(Aspose::Words::Drawing::WrapType::Inline); paragraph->AppendChild>(shape); paragraph->AppendChild>(System::MakeObject(doc, u"Hello again!")); // Итерируйтесь по коллекции непосредственных дочерних элементов абзаца, // и выводите любые фрагменты текста или фигуры, которые мы находим внутри. System::SharedPtr children = paragraph->GetChildNodes(Aspose::Words::NodeType::Any, false); ASSERT_EQ(3, paragraph->GetChildNodes(Aspose::Words::NodeType::Any, false)->get_Count()); for (auto&& child : System::IterateOver(children)) { switch (child->get_NodeType()) { case Aspose::Words::NodeType::Run: std::cout << "Run contents:" << std::endl; std::cout << System::String::Format(u"\t\"{0}\"", child->GetText().Trim()) << std::endl; break; case Aspose::Words::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; } } ``` ## См. также * Class [Node](../node/) * Namespace [Aspose::Words](../) * Library [Aspose.Words for C++](../../)