Partager via


Comment : créer des tableaux Word par programmation

La collection Tables est un membre des classes Microsoft.Office.Interop.Word.Document, Microsoft.Office.Tools.Word.Document, Selection et Range, ce qui signifie que vous pouvez créer un tableau dans l'un de ces contextes.La méthode Add de la collection Tables permet d'ajouter un tableau au niveau de la plage spécifiée.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Word 2013 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Création de tableaux dans des personnalisations au niveau du document

Pour ajouter un tableau simple à un document

  • Utilisez la méthode Add pour ajouter un tableau comprenant trois lignes et quatre colonnes au début du document.

    Pour utiliser l'exemple de code suivant, exécutez-le à partir de la classe ThisDocument dans votre projet.

    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 Microsoft.Office.Tools.Word.Document.Vous pouvez alors faire référence au tableau par son numéro d'élément à l'aide de la propriété Item, comme illustré dans le code suivant.

Pour faire référence à un tableau à l'aide de son numéro d'élément

  • Utilisez la propriété Item et fournissez le numéro d'élément du tableau auquel vous souhaitez faire référence.

    Pour utiliser l'exemple de code suivant, exécutez-le à partir de la classe ThisDocument dans votre projet.

    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.

Pour appliquer un style à un tableau

  • Utilisez la propriété Style pour appliquer au tableau l'un des styles intégrés dans Word :

    Pour utiliser l'exemple de code suivant, exécutez-le à partir de la classe ThisDocument dans votre projet.

    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éation de tableaux dans des compléments au niveau de l'application

Pour ajouter un tableau simple à un document

  • Utilisez la méthode Add pour ajouter un tableau comprenant trois lignes et quatre colonnes au début du document.

    L'exemple de code suivant ajoute un tableau au document actif.Pour utiliser cet exemple, exécutez-le à partir de la classe ThisAddIn dans votre projet.

    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 du Microsoft.Office.Interop.Word.Document.Vous pouvez alors faire référence au tableau par son numéro d'élément à l'aide de la propriété Item, comme illustré dans le code suivant.

Pour faire référence à un tableau à l'aide de son numéro d'élément

  • Utilisez la propriété Item et fournissez le numéro d'élément du tableau auquel vous souhaitez faire référence.

    L'exemple de code suivant utilise le document actif.Pour utiliser cet exemple, exécutez-le à partir de la classe ThisAddIn dans votre projet.

    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.

Pour appliquer un style à un tableau

  • Utilisez la propriété Style pour appliquer au tableau l'un des styles intégrés dans Word :

    L'exemple de code suivant utilise le document actif.Pour utiliser cet exemple, exécutez-le à partir de la classe ThisAddIn dans votre projet.

    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 aussi

Tâches

Comment : ajouter du texte et une mise en forme aux cellules des tableaux Word par programmation

Comment : ajouter des lignes et des colonnes à des tableaux Word par programmation

Comment : remplir des tableaux Word avec des propriétés de document par programmation

Concepts

Paramètres optionnels dans les solutions Office