Range.ConvertToTable, méthode (Word)

  • Article

Convertit le texte d'une plage à un tableau. Renvoie le tableau sous la forme d'un objet Table.

Syntaxe

expression. ConvertToTable( _Separator_ , _NumRows_ , _NumColumns_ , _InitialColumnWidth_ , _Format_ , _ApplyBorders_ , _ApplyShading_ , _ApplyFont_ , _ApplyColor_ , _ApplyHeadingRows_ , _ApplyLastRow_ , _ApplyFirstColumn_ , _ApplyLastColumn_ , _AutoFit_ , _AutoFitBehavior_ , _DefaultTableBehavior_ )

expression Variable représentant un objet Range.

Paramètres

Nom Requis/Facultatif Type de données Description
Separator Facultatif Variant Spécifie le caractère utilisé pour séparer le texte dans des cellules. Peut être un caractère ou l'une des constantes WdTableFieldSeparator suivantes. Si cet argument est omis, la valeur de la propriété DefaultTableSeparator est utilisée.
NumRows Facultatif Variant Nombre de lignes du tableau. Si vous ne spécifiez pas cet argument, Microsoft Word définit le nombre de lignes en fonction du contenu de la plage.
NumColumns Facultatif Variant Nombre de colonnes du tableau. Si vous ne spécifiez pas cet argument, Word définit le nombre de colonnes en fonction du contenu de la plage.
InitialColumnWidth Facultatif Variant Largeur initiale de chaque colonne, exprimée en points. Si vous ne spécifiez pas cet argument, Word calcule et ajuste la largeur des colonnes de sorte que le tableau s'étire d'une marge à l'autre.
Format Facultatif Variant Spécifie un des formats prédéfinis répertoriés dans la boîte de dialogue Mise en forme automatique de tableau. Peut être une des constantes WdTableFormat.
ApplyBorders Facultatif Variant True pour appliquer les propriétés de la bordure du format spécifié.
ApplyShading Facultatif Variant True pour appliquer les propriétés de trame de fond du format spécifié.
ApplyFont Facultatif Variant True pour appliquer les propriétés de police du format spécifié.
ApplyColor Facultatif Variant True pour appliquer les propriétés de couleur du format spécifié.
ApplyHeadingRows Facultatif Variant True pour appliquer les propriétés de ligne de titre de la mise en forme spécifiée.
ApplyLastRow Facultatif Variant True pour appliquer les propriétés de dernière ligne du format spécifié.
ApplyFirstColumn Facultatif Variant True pour appliquer les propriétés de première colonne du format spécifié.
ApplyLastColumn Facultatif Variant True pour appliquer les propriétés de dernière colonne du format spécifié.
AutoFit Facultatif Variant True pour diminuer la largeur des colonnes du tableau autant que possibles sans modifier la façon dont le texte s'ajuste dans les cellules.
AutoFitBehavior Facultatif Variant Définit les règles d'ajustement automatique de la façon dont Word redimensionne un tableau. Peut être une des constantes WdAutoFitBehavior suivantes. Si DefaultTableBehavior a wdWord8TableBehavior, cet argument est ignoré.
DefaultTableBehavior Facultatif Variant Définit une valeur qui indique si Microsoft Word redimensionne automatiquement les cellules d'un tableau pour s'adapter au contenu (ajustement automatique). Peut être une des constantes WdDefaultTableBehavior.

Valeur renvoyée

Table

Exemple

Cet exemple montre comment convertir en tableau les trois premiers paragraphes du document actif.

Set aDoc = ActiveDocument 
Set myRange = aDoc.Range(Start:=aDoc.Paragraphs(1).Range.Start, _ 
 End:=aDoc.Paragraphs(3).Range.End) 
myRange.ConvertToTable Separator:=wdSeparateByParagraphs

Voir aussi

Range, objet

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.