GetChild

CompositeNode.GetChild method

返回与指定类型匹配的第 N 个子节点。

public Node GetChild(NodeType nodeType, int index, bool isDeep)
范围类型描述
nodeTypeNodeType指定子节点的类型。
indexInt32要选择的子节点的从零开始的索引。 也允许负索引，表示从末尾开始访问， 即 -1 表示最后一个节点。
isDeepBoolean真的递归地从所有子节点中选择； 错误的仅在直系子代中进行选择。请参阅备注了解更多信息。

返回值

符合条件的子节点或无效的如果没有找到匹配的节点。

评论

如果索引超出范围，则无效的被返回。

请注意，标记节点 (StructuredDocumentTag和SmartTag ) 即使在以下情况下也会被遍历isDeep=错误的和GetChild为非标记节点类型调用。例如，如果 para 中的第一次运行被包装在StructuredDocumentTag，它仍然会被返回GetChild（Run , 0,错误的）。

例子

演示如何将表格样式的属性直接应用于表格的元素。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Hello world!");
builder.EndTable();

TableStyle tableStyle = (TableStyle)doc.Styles.Add(StyleType.Table, "MyTableStyle1");
tableStyle.RowStripe = 3;
tableStyle.CellSpacing = 5;
tableStyle.Shading.BackgroundPatternColor = Color.AntiqueWhite;
tableStyle.Borders.Color = Color.Blue;
tableStyle.Borders.LineStyle = LineStyle.DotDash;

table.Style = tableStyle;

// 此方法涉及表格样式属性，例如我们上面设置的属性。
doc.ExpandTableStylesToDirectFormatting();

doc.Save(ArtifactsDir + "Document.TableStyleToDirectFormatting.docx");

演示如何遍历复合节点的子节点集合。

Document doc = new Document();

// 将两个运行和一个形状作为子节点添加到本文档的第一段。
Paragraph paragraph = (Paragraph)doc.GetChild(NodeType.Paragraph, 0, true);
paragraph.AppendChild(new Run(doc, "Hello world! "));

Shape shape = new Shape(doc, ShapeType.Rectangle);
shape.Width = 200;
shape.Height = 200;
// 请注意，“CustomNodeId”不会保存到输出文件中，并且仅在节点生命周期内存在。
shape.CustomNodeId = 100;
shape.WrapType = WrapType.Inline;
paragraph.AppendChild(shape);

paragraph.AppendChild(new Run(doc, "Hello again!"));

// 遍历该段落的直接子级集合，
// 并打印我们在其中找到的任何运行或形状。
NodeCollection children = paragraph.GetChildNodes(NodeType.Any, false);

Assert.AreEqual(3, paragraph.GetChildNodes(NodeType.Any, false).Count);

foreach (Node child in children)
    switch (child.NodeType)
    {
        case NodeType.Run:
            Console.WriteLine("Run contents:");
            Console.WriteLine($"\t\"{child.GetText().Trim()}\"");
            break;
        case NodeType.Shape:
            Shape childShape = (Shape)child;
            Console.WriteLine("Shape:");
            Console.WriteLine($"\t{childShape.ShapeType}, {childShape.Width}x{childShape.Height}");
            break;
    }

也可以看看

CompositeNode.CreateNavigator CompositeNode.GetChildNodes