GetChild

CompositeNode.GetChild method

Devuelve un nodo secundario N que coincide con el tipo especificado.

public Node GetChild(NodeType nodeType, int index, bool isDeep)
ParámetroEscribeDescripción
nodeTypeNodeTypeEspecifica el tipo de nodo secundario.
indexInt32Índice basado en cero del nodo hijo a seleccionar. También se permiten índices negativos e indican acceso desde el final, es decir -1 significa el último nodo.
isDeepBooleanverdadero para seleccionar entre todos los nodos secundarios de forma recursiva; FALSO Para seleccionar solo entre los hijos inmediatos. Ver comentarios para más información.

Valor_devuelto

El nodo secundario que coincide con los criterios onulo si no se encuentra ningún nodo coincidente.

Observaciones

Si el índice está fuera de rango, unnulo se devuelve.

Tenga en cuenta que los nodos de marcado (StructuredDocumentTag ySmartTag ) se recorren incluso cuandoisDeep =FALSO yGetChild Se invoca para un tipo de nodo sin marcado. Por ejemplo, si la primera ejecución de un para está envuelta en unStructuredDocumentTag , todavía será devuelto porGetChild(Run , 0,FALSO).

Ejemplos

Muestra cómo aplicar las propiedades del estilo de una tabla directamente a los elementos de la tabla.

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;

// Este método se refiere a propiedades de estilo de tabla como las que configuramos anteriormente.
doc.ExpandTableStylesToDirectFormatting();

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

Muestra cómo recorrer la colección de nodos secundarios de un nodo compuesto.

Document doc = new Document();

// Agregue dos ejecuciones y una forma como nodos secundarios al primer párrafo de este documento.
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;
// Tenga en cuenta que 'CustomNodeId' no se guarda en un archivo de salida y solo existe durante la vida útil del nodo.
shape.CustomNodeId = 100;
shape.WrapType = WrapType.Inline;
paragraph.AppendChild(shape);

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

// Iterar a través de la colección de hijos inmediatos del párrafo,
// e imprimir cualquier recorrido o forma que encontremos dentro.
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;
    }

Ver también

CompositeNode.CreateNavigator CompositeNode.GetChildNodes