Gewusst wie: Programmgesteuertes Erstellen von Word-Tabellen

Die Tables-Auflistung ist ein Member der Klassen Microsoft.Office.Interop.Word.Document, Microsoft.Office.Tools.Word.Document, Selection und Range. Daher können Sie in diesen Kontexten eine Tabelle erstellen.Mit der Add-Methode der Tables-Auflistung können Sie im angegebenen Bereich eine Tabelle hinzufügen.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und auf Anwendungsebene für Word 2013 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Erstellen von Tabellen in Anpassungen auf Dokumentebene

So fügen Sie einem Dokument eine einfache Tabelle hinzu

• Mit der Add-Methode können Sie eine Tabelle aus drei Zeilen und vier Spalten am Anfang des Dokuments hinzufügen.

  Wenn Sie das folgende Codebeispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse im Projekt aus.

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

Wenn Sie eine Tabelle erstellen, wird diese automatisch der Tables-Auflistung des Microsoft.Office.Tools.Word.Document-Hostelements hinzugefügt.Anschließend können Sie mit der Elementnummer auf die Tabelle verweisen, indem Sie die Item-Eigenschaft verwenden, wie im folgenden Codebeispiel veranschaulicht.

So verweisen Sie auf eine Tabelle anhand ihrer Elementnummer

• Verwenden Sie die Item-Eigenschaft, und übergeben Sie die Elementnummer der Tabelle, auf die Sie verweisen möchten.

  Wenn Sie das folgende Codebeispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse im Projekt aus.

  Dim newTable As Word.Table = Me.Tables.Item(1)
  

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

Jedes Table-Objekt verfügt außerdem über eine Range-Eigenschaft. Diese ermöglicht es Ihnen, Attribute für das Formatieren festzulegen.

So weisen Sie einer Tabelle eine Formatvorlage zu

• Verwenden Sie die Style-Eigenschaft, um einen der integrierten Word-Stile in eine Tabelle zu übernehmen.

  Wenn Sie das folgende Codebeispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse im Projekt aus.

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

Erstellen von Tabellen in Add-Ins auf Anwendungsebene

So fügen Sie einem Dokument eine einfache Tabelle hinzu

• Mit der Add-Methode können Sie eine Tabelle aus drei Zeilen und vier Spalten am Anfang des Dokuments hinzufügen.

  Im folgenden Codebeispiel wird dem aktiven Dokument eine Tabelle hinzugefügt.Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisAddIn-Klasse im Projekt aus.

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

Wenn Sie eine Tabelle erstellen, wird diese automatisch der Tables-Auflistung des Microsoft.Office.Interop.Word.Document hinzugefügt.Anschließend können Sie mit der Elementnummer auf die Tabelle verweisen, indem Sie die Item-Eigenschaft verwenden, wie im folgenden Codebeispiel veranschaulicht.

So verweisen Sie auf eine Tabelle anhand ihrer Elementnummer

• Verwenden Sie die Item-Eigenschaft, und übergeben Sie die Elementnummer der Tabelle, auf die Sie verweisen möchten.

  Im folgenden Codebeispiel wird das aktive Dokument verwendet.Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisAddIn-Klasse im Projekt aus.

  Dim newTable As Word.Table = Me.Application.ActiveDocument.Tables.Item(1)
  

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

Jedes Table-Objekt verfügt außerdem über eine Range-Eigenschaft. Diese ermöglicht es Ihnen, Attribute für das Formatieren festzulegen.

So weisen Sie einer Tabelle eine Formatvorlage zu

• Verwenden Sie die Style-Eigenschaft, um einen der integrierten Word-Stile in eine Tabelle zu übernehmen.

  Im folgenden Codebeispiel wird das aktive Dokument verwendet.Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisAddIn-Klasse im Projekt aus.

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

Siehe auch

Aufgaben

Gewusst wie: Programmgesteuertes Hinzufügen von Text und Formatierungen zu Zellen in Word-Tabellen

Gewusst wie: Programmgesteuertes Hinzufügen von Zeilen und Spalten zu Word-Tabellen

Gewusst wie: Programmgesteuertes Auffüllen von Word-Tabellen mit Dokumenteigenschaften

Konzepte

Optionale Parameter in Office-Lösungen