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

La colección Tables es un miembro de las clases Microsoft.Office.Interop.Word.Document, Microsoft.Office.Tools.Word.Document, Selection y Range; esto significa que puede crear una tabla en cualquiera de esos contextos.Para agregar una tabla en el rango especificado, utiliza el método Add de la colección Tables.

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

Crear tablas en personalizaciones de nivel de documento

Para agregar una tabla sencilla a un documento

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

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

  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);
  

Cuando crea una tabla, se agrega automáticamente a la colección Tables del elemento host Microsoft.Office.Tools.Word.Document.Esto permite hacer referencia a la tabla por su número de elemento mediante la propiedad Item, como se muestra en el código siguiente.

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

• Utilice la propiedad Item y proporcione el número del elemento de la tabla a la que desea hacer referencia.

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

  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 permite establecer atributos de formato.

Para aplicar un estilo a una tabla

• Utilice la propiedad Style para aplicar uno de los estilos integrados de Word a una tabla.

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

  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 nivel de aplicación

Para agregar una tabla sencilla a un documento

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

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

  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);
  

Cuando crea una tabla, se agrega automáticamente a la colección Tables de la clase Microsoft.Office.Interop.Word.Document.Esto permite hacer referencia a la tabla por su número de elemento mediante la propiedad Item, como se muestra en el código siguiente.

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

• Utilice la propiedad Item y proporcione el número del elemento de la tabla a la que desea hacer referencia.

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

  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 permite establecer atributos de formato.

Para aplicar un estilo a una tabla

• Utilice la propiedad Style para aplicar uno de los estilos integrados de Word a una tabla.

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

  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én

Tareas

Cómo: Agregar texto y formato a celdas de tablas de Word mediante programación

Cómo: Agregar filas y columnas a tablas de Word mediante programación

Cómo: Rellenar tablas de Word con propiedades de documento mediante programación

Conceptos

Parámetros opcionales en las soluciones de Office