Cómo: Crear tablas de Word

Actualización: noviembre 2007

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.

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, ref missing, ref missing);
  

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"
  

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

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)
  

  object start = 0;
  object end = 0;
  
  Word.Range tableLocation = 
      this.Application.ActiveDocument.Range(ref start, ref end);
  this.Application.ActiveDocument.Tables.Add(
      tableLocation, 3, 4, ref missing, ref missing);
  

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"
  

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

Vea también

Tareas

Cómo: Agregar texto y formato a las celdas de las tablas de Word

Cómo: Agregar filas y columnas a las tablas de Word

Cómo: Rellenar tablas de Word con propiedades de documento

Conceptos

Descripción de los parámetros opcionales en las soluciones de Office