node_type property

Node.node_type property

Gets the type of this node.

@property
def node_type(self) -> aspose.words.NodeType:
    ...

Examples

Shows how to traverse a composite node’s tree of child nodes.

def test_recurse_children(self):

    doc = aw.Document(MY_DIR + "Paragraphs.docx")

    # Any node that can contain child nodes, such as the document itself, is composite.
    self.assertTrue(doc.is_composite)

    # Invoke the recursive function that will go through and print all the child nodes of a composite node.
    ExNode.traverse_all_nodes(doc, 0)

@staticmethod
def traverse_all_nodes(parent_node: aw.CompositeNode, depth: int):
    """Recursively traverses a node tree while printing the type of each node
    with an indent depending on depth as well as the contents of all inline nodes."""

    child_node = parent_node.first_child
    while child_node is not None:

        print("\t" * depth + aw.Node.node_type_to_string(child_node.node_type), end="")

        # Recurse into the node if it is a composite node. Otherwise, print its contents if it is an inline node.
        if child_node.is_composite:
            print()
            ExNode.traverse_all_nodes(child_node.as_composite_node(), depth + 1)

        elif child_node is aw.Inline:
            print(f" - \"{child_node.get_text().strip()}\"")

        else:
            print()

        child_node = child_node.next_sibling

Shows how to remove all child nodes of a specific type from a composite node.

doc = aw.Document(MY_DIR + "Tables.docx")

self.assertEqual(2, doc.get_child_nodes(aw.NodeType.TABLE, True).count)

cur_node = doc.first_section.body.first_child

while cur_node is not None:

    # Save the next sibling node as a variable in case we want to move to it after deleting this node.
    next_node = cur_node.next_sibling

    # A section body can contain Paragraph and Table nodes.
    # If the node is a Table, remove it from the parent.
    if cur_node.node_type == aw.NodeType.TABLE:
        cur_node.remove()

    cur_node = next_node

self.assertEqual(0, doc.get_child_nodes(aw.NodeType.TABLE, True).count)

Shows how to use a node’s next_sibling property to enumerate through its immediate children.

doc = aw.Document(MY_DIR + "Paragraphs.docx")

node = doc.first_section.body.first_child
while node is not None:
    print()
    print("Node type:", aw.Node.node_type_to_string(node.node_type))

    contents = node.get_text().strip()
    print("This node contains no text" if contents == "" else f'Contents: "{node.get_text().strip()}"')

    node = node.next_sibling

node_type property

Node.node_type property

Examples

See Also