Comment : créer des tableaux Word par programmationHow to: Programmatically create Word tables

La collection Tables est membre des classes Document, DocumentSelection et Range, ce qui signifie que vous pouvez créer un tableau dans l'un de ces contextes.The Tables collection is a member of the Document, Document, Selection, and Range classes, which means that you can create a table in any of those contexts. La méthode Add de la collection Tables permet d'ajouter un tableau au niveau de la plage spécifiée.You use the Add method of the Tables collection to add a table at the specified range.

S’applique à : les informations contenues dans cette rubrique s’applique au document-projets et ajouter de VSTO de niveau-dans les projets pour Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. Pour plus d’informations, consultez fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features available by Office application and project type.

Créer des tables dans des personnalisations au niveau du documentCreate tables in document-level customizations

Pour ajouter une table à un documentTo add a table to a document

  • Utilisez la méthode Add pour ajouter un tableau comprenant trois lignes et quatre colonnes au début du document.Use the Add method to add a table consisting of three rows and four columns at the beginning of the document.

    Pour utiliser l'exemple de code suivant, exécutez-le à partir de la classe ThisDocument de votre projet.To use the following code example, run it from the ThisDocument class in your project.

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

    Lorsque vous créez un tableau, il est automatiquement ajouté à la collection Tables de l'élément hôte Document.When you create a table, it is automatically added to the Tables collection of the Document host item. Vous pouvez alors faire référence au tableau par son numéro d'élément à l'aide de la propriété Item[Int32], comme illustré dans le code suivant.You can then refer to the table by its item number by using the Item[Int32] property, as shown in the following code.

Pour faire référence à un tableau à l'aide de son numéro d'élémentTo refer to a table by item number

  1. Utilisez la propriété Item[Int32] et fournissez le numéro d'élément du tableau auquel vous souhaitez faire référence.Use the Item[Int32] property and supply the item number of the table that you want to refer to.

    Pour utiliser l'exemple de code suivant, exécutez-le à partir de la classe ThisDocument de votre projet.To use the following code example, run it from the ThisDocument class in your project.

    Dim newTable As Word.Table = Me.Tables.Item(1)
    
    Word.Table newTable = this.Tables[1];
    

    Chaque objet Table possède également une propriété Range qui vous permet de définir des attributs de mise en forme.Each Table object also has a Range property that enables you to set formatting attributes.

Pour appliquer un style à un tableauTo apply a style to a table

  1. Utilisez la propriété Style pour appliquer au tableau l'un des styles intégrés de Word.Use the Style property to apply one of the Word built-in styles to a table.

    Pour utiliser l'exemple de code suivant, exécutez-le à partir de la classe ThisDocument de votre projet.To use the following code example, run it from the ThisDocument class in your project.

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

Créer des tables dans des Compléments VSTOCreate tables in VSTO Add-ins

Pour ajouter une table à un documentTo add a table to a document

  • Utilisez la méthode Add pour ajouter un tableau comprenant trois lignes et quatre colonnes au début du document.Use the Add method to add a table consisting of three rows and four columns at the beginning of the document.

    L'exemple de code suivant ajoute un tableau au document actif.The following code example adds a table to the active document. Pour utiliser cet exemple, exécutez-le à partir de la classe ThisAddIn dans votre projet.To use this example, run it from the ThisAddIn class in your project.

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

    Lorsque vous créez un tableau, il est automatiquement ajouté à la collection Tables de l'élément Document.When you create a table, it is automatically added to the Tables collection of the Document. Vous pouvez alors faire référence au tableau par son numéro d'élément à l'aide de la propriété Item[Int32], comme illustré dans le code suivant.You can then refer to the table by its item number by using the Item[Int32] property, as shown in the following code.

Pour faire référence à un tableau à l'aide de son numéro d'élémentTo refer to a table by item number

  1. Utilisez la propriété Item[Int32] et fournissez le numéro d'élément du tableau auquel vous souhaitez faire référence.Use the Item[Int32] property and supply the item number of the table that you want to refer to.

    L'exemple de code suivant utilise le document actif.The following code example uses the active document. Pour utiliser cet exemple, exécutez-le à partir de la classe ThisAddIn dans votre projet.To use this example, run it from the ThisAddIn class in your project.

    Dim newTable As Word.Table = Me.Application.ActiveDocument.Tables.Item(1)
    
    Word.Table newTable = this.Application.ActiveDocument.Tables[1];
    

    Chaque objet Table possède également une propriété Range qui vous permet de définir des attributs de mise en forme.Each Table object also has a Range property that enables you to set formatting attributes.

Pour appliquer un style à un tableauTo apply a style to a table

  1. Utilisez la propriété Style pour appliquer au tableau l'un des styles intégrés de Word.Use the Style property to apply one of the Word built-in styles to a table.

    L'exemple de code suivant utilise le document actif.The following code example uses the active document. Pour utiliser cet exemple, exécutez-le à partir de la classe ThisAddIn dans votre projet.To use this example, run it from the ThisAddIn class in your project.

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

Voir aussiSee also

Comment : ajouter texte et mise en forme aux cellules des tableaux Word par programmation How to: Programmatically add text and formatting to cells in Word tables
Comment : ajouter par programmation des lignes et colonnes à des tableaux Word How to: Programmatically add rows and columns to Word tables
Comment : remplir par programmation des tableaux Word avec des propriétés de document How to: Programmatically populate Word tables with document properties
Paramètres optionnels dans les solutions OfficeOptional parameters in Office solutions