Freigeben über


Gewusst wie: Erstellen von Word-Tabellen

Aktualisiert: November 2007

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

  • Projekte auf Dokumentebene

  • Projekte auf Anwendungsebene

Microsoft Office-Version

  • Word 2003

  • Word 2007

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

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.

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

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"
    
    object styleName = "Table Grid 8";
    
    this.Tables[1].Range.Font.Size = 8;
    this.Tables[1].set_Style(ref styleName);
    

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

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"
    
    object styleName = "Table Grid 8";
    
    this.Application.ActiveDocument.Tables[1].Range.Font.Size = 8;
    this.Application.ActiveDocument.Tables[1].set_Style(ref styleName);
    

Siehe auch

Aufgaben

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

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

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

Konzepte

Optionale Parametern in Office-Projektmappen