Comment : créer des tableaux Word

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Projets au niveau de l'application Version de Microsoft Office Word 2003 Word 2007 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

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.

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

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"
  

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

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)
  

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

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"
  

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

Voir aussi

Tâches

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

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

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

Concepts

Fonctionnement des paramètres optionnels dans les solutions Office