add method
add(node)
Adds a node to the end of the collection.
def add(self, node: aspose.words.Node):
...
| Parameter | Type | Description |
|---|---|---|
| node | Node | The node to be added to the end of the collection. |
Remarks
The node is inserted as a child into the node object from which the collection was created.
If the node being inserted was created from another document, you should use DocumentBase.import_node() to import the node to the current document. The imported node can then be inserted into the current document.
Exceptions
| exception | condition |
|---|---|
| RuntimeError (Proxy error(NotSupportedException)) | The NodeCollection is a “deep” collection. |
Examples
Shows how to prepare a new section node for editing.
doc = aw.Document()
# A blank document comes with a section, which has a body, which in turn has a paragraph.
# We can add contents to this document by adding elements such as text runs, shapes, or tables to that paragraph.
self.assertEqual(aw.NodeType.SECTION, doc.get_child(aw.NodeType.ANY, 0, True).node_type)
self.assertEqual(aw.NodeType.BODY, doc.sections[0].get_child(aw.NodeType.ANY, 0, True).node_type)
self.assertEqual(aw.NodeType.PARAGRAPH, doc.sections[0].body.get_child(aw.NodeType.ANY, 0, True).node_type)
# If we add a new section like this, it will not have a body, or any other child nodes.
doc.sections.add(aw.Section(doc))
self.assertEqual(0, doc.sections[1].get_child_nodes(aw.NodeType.ANY, True).count)
# Run the "ensure_minimum" method to add a body and a paragraph to this section to begin editing it.
doc.last_section.ensure_minimum()
self.assertEqual(aw.NodeType.BODY, doc.sections[1].get_child(aw.NodeType.ANY, 0, True).node_type)
self.assertEqual(aw.NodeType.PARAGRAPH, doc.sections[1].body.get_child(aw.NodeType.ANY, 0, True).node_type)
doc.sections[0].body.first_paragraph.append_child(aw.Run(doc, "Hello world!"))
self.assertEqual("Hello world!", doc.get_text().strip())
See Also
- module aspose.words
- class NodeCollection