Cómo: Crear tablas de Word mediante programaciónHow to: Programmatically Create Word Tables

La colección Tables es un miembro de las clases Document, Document, Selection y Range, lo que significa que puede crear una tabla en cualquiera de estos contextos.The Tables collection is a member of the Document, Document, Selection, and Range classes, which means that you can create a table in any of those contexts. Use el método Add de la colección Tables para agregar una tabla al intervalo especificado.You use the Add method of the Tables collection to add a table at the specified range.

Se aplica a: la información de este tema se aplica al documento-proyectos y agregar de VSTO de nivel-en los proyectos de Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. Para obtener más información, consulte características disponibles por tipo de aplicación y el proyecto de Office.For more information, see Features available by Office application and project type.

Crear tablas en personalizaciones de nivel de documentoCreating Tables in Document-Level Customizations

Para agregar una tabla sencilla a un documentoTo add a simple table to a document

  • Use el método Add para agregar una tabla que conste de tres filas y cuatro columnas al principio del documento.Use the Add method to add a table consisting of three rows and four columns at the beginning of the document.

    Para usar el siguiente ejemplo de código, ejecútelo desde la clase ThisDocument del proyecto.To use the following code example, run it from the ThisDocument class in your project.

    Dim tableLocation As Word.Range = Me.Range(Start:=0, End:=0)
    Me.Tables.Add(Range:=tableLocation, NumRows:=3, NumColumns:=4)
    
    object start = 0;
    object end = 0;
    Word.Range tableLocation = this.Range(ref start, ref end);
    this.Tables.Add(tableLocation, 3, 4);
    

    Al crear una tabla, se agrega automáticamente a la colección Tables del elemento host Document.When you create a table, it is automatically added to the Tables collection of the Document host item. Después, puede hacer referencia a la tabla por su número de elemento usando la propiedad Item[Int32], como se muestra en el código siguiente.You can then refer to the table by its item number by using the Item[Int32] property, as shown in the following code.

Para hacer referencia a una tabla por su número de elementoTo refer to a table by item number

  1. Use la propiedad Item[Int32] y proporcione el número de elemento de la tabla a la que desee hacer referencia.Use the Item[Int32] property and supply the item number of the table that you want to refer to.

    Para usar el siguiente ejemplo de código, ejecútelo desde la clase ThisDocument del proyecto.To use the following code example, run it from the ThisDocument class in your project.

    Dim newTable As Word.Table = Me.Tables.Item(1)
    
    Word.Table newTable = this.Tables[1];
    

    Cada objeto Table tiene también una propiedad Range que le permite establecer atributos de formato.Each Table object also has a Range property that enables you to set formatting attributes.

Para aplicar un estilo a una tablaTo apply a style to a table

  1. Use la propiedad Style para aplicar a una tabla uno de los estilos integrados en Word.Use the Style property to apply one of the Word built-in styles to a table.

    Para usar el siguiente ejemplo de código, ejecútelo desde la clase ThisDocument del proyecto.To use the following code example, run it from the ThisDocument class in your project.

    Me.Tables.Item(1).Range.Font.Size = 8
    Me.Tables.Item(1).Style = "Table Grid 8"
    
    this.Tables[1].Range.Font.Size = 8;
    this.Tables[1].set_Style("Table Grid 8");
    

Crear tablas en complementos de VSTOCreating Tables in VSTO Add-ins

Para agregar una tabla sencilla a un documentoTo add a simple table to a document

  • Use el método Add para agregar una tabla que conste de tres filas y cuatro columnas al principio del documento.Use the Add method to add a table consisting of three rows and four columns at the beginning of the document.

    En el siguiente ejemplo de código se agrega una tabla al documento activo.The following code example adds a table to the active document. Para usar este ejemplo, ejecútelo desde la clase ThisAddIn del proyecto.To use this example, run it from the ThisAddIn class in your project.

    Dim tableLocation As Word.Range = Me.Application.ActiveDocument.Range(Start:=0, End:=0)
    Me.Application.ActiveDocument.Tables.Add(Range:=tableLocation, NumRows:=3, NumColumns:=4)
    
    Word.Range tableLocation = 
        this.Application.ActiveDocument.Range(0, 0);
    this.Application.ActiveDocument.Tables.Add(
        tableLocation, 3, 4);
    

    Al crear una tabla, se agrega automáticamente a la colección Tables del Document.When you create a table, it is automatically added to the Tables collection of the Document. Después, puede hacer referencia a la tabla por su número de elemento usando la propiedad Item[Int32], como se muestra en el código siguiente.You can then refer to the table by its item number by using the Item[Int32] property, as shown in the following code.

Para hacer referencia a una tabla por su número de elementoTo refer to a table by item number

  1. Use la propiedad Item[Int32] y proporcione el número de elemento de la tabla a la que desee hacer referencia.Use the Item[Int32] property and supply the item number of the table that you want to refer to.

    En el siguiente ejemplo de código se usa el documento activo.The following code example uses the active document. Para usar este ejemplo, ejecútelo desde la clase ThisAddIn del proyecto.To use this example, run it from the ThisAddIn class in your project.

    Dim newTable As Word.Table = Me.Application.ActiveDocument.Tables.Item(1)
    
    Word.Table newTable = this.Application.ActiveDocument.Tables[1];
    

    Cada objeto Table tiene también una propiedad Range que le permite establecer atributos de formato.Each Table object also has a Range property that enables you to set formatting attributes.

Para aplicar un estilo a una tablaTo apply a style to a table

  1. Use la propiedad Style para aplicar a una tabla uno de los estilos integrados en Word.Use the Style property to apply one of the Word built-in styles to a table.

    En el siguiente ejemplo de código se usa el documento activo.The following code example uses the active document. Para usar este ejemplo, ejecútelo desde la clase ThisAddIn del proyecto.To use this example, run it from the ThisAddIn class in your project.

    Me.Application.ActiveDocument.Tables.Item(1).Range.Font.Size = 8
    Me.Application.ActiveDocument.Tables.Item(1).Style = "Table Grid 8"
    
    this.Application.ActiveDocument.Tables[1].Range.Font.Size = 8;
    this.Application.ActiveDocument.Tables[1].set_Style("Table Grid 8");
    

Vea tambiénSee Also

Cómo: agregar texto y formato a las celdas de las tablas de Word mediante programación How to: Programmatically Add Text and Formatting to Cells in Word Tables
Cómo: agregar mediante programación filas y columnas a las tablas de Word How to: Programmatically Add Rows and Columns to Word Tables
Cómo: rellenar mediante programación las tablas de Word con propiedades de documento How to: Programmatically Populate Word Tables with Document Properties
Parámetros opcionales en las soluciones de OfficeOptional Parameters in Office Solutions