Cómo: Crear tablas de Word mediante programación

Se aplica a:yesnoVisual Studio Visual Studio para Mac Visual Studio Code no

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. Use el método Add de la colección Tables para agregar una tabla al intervalo especificado.

Se aplica a: La información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO para Word. Para obtener más información, vea Características disponibles por Office tipo de proyecto y aplicación.

Creación de tablas en personalizaciones de nivel de documento

Para agregar una tabla a un documento

  • Use el método Add para agregar una tabla que conste de tres filas y cuatro columnas al principio del documento.

    Para usar el siguiente ejemplo de código, ejecútelo desde la clase ThisDocument del proyecto.

    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. Después, puede hacer referencia a la tabla por su número de elemento usando la propiedad Item[], como se muestra en el código siguiente.

Para hacer referencia a una tabla por su número de elemento

  1. Use la propiedad Item[] y proporcione el número de elemento de la tabla a la que desee hacer referencia.

    Para usar el siguiente ejemplo de código, ejecútelo desde la clase ThisDocument del proyecto.

    Word.Table newTable = this.Tables[1];
    

    Cada objeto Table tiene también una propiedad Range que le permite establecer atributos de formato.

Para aplicar un estilo a una tabla

  1. Use la propiedad Style para aplicar a una tabla uno de los estilos integrados en Word.

    Para usar el siguiente ejemplo de código, ejecútelo desde la clase ThisDocument del proyecto.

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

Crear tablas en complementos de VSTO

Para agregar una tabla a un documento

  • Use el método Add para agregar una tabla que conste de tres filas y cuatro columnas al principio del documento.

    En el siguiente ejemplo de código se agrega una tabla al documento activo. Para usar este ejemplo, ejecútelo desde la clase ThisAddIn del proyecto.

    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. Después, puede hacer referencia a la tabla por su número de elemento usando la propiedad Item[], como se muestra en el código siguiente.

Para hacer referencia a una tabla por su número de elemento

  1. Use la propiedad Item[] y proporcione el número de elemento de la tabla a la que desee hacer referencia.

    En el siguiente ejemplo de código se usa el documento activo. Para usar este ejemplo, ejecútelo desde la clase ThisAddIn del proyecto.

    Word.Table newTable = this.Application.ActiveDocument.Tables[1];
    

    Cada objeto Table tiene también una propiedad Range que le permite establecer atributos de formato.

Para aplicar un estilo a una tabla

  1. Use la propiedad Style para aplicar a una tabla uno de los estilos integrados en Word.

    En el siguiente ejemplo de código se usa el documento activo. Para usar este ejemplo, ejecútelo desde la clase ThisAddIn del proyecto.

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

Consulte también