Méthode Selection.ConvertToTable (Word)

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 qui représente un objet Selection .

Parameters

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

Tableau

Exemple

Cet exemple montre comment insérer du texte au niveau du point d'insertion, puis convertir en tableau avec mise en forme le texte délimité par des virgules.

With Selection 
 .Collapse 
 .InsertBefore "one, two, three" 
 .InsertParagraphAfter 
 .InsertAfter "one, two, three" 
 .InsertParagraphAfter 
End With 
Set myTable = Selection.ConvertToTable( _ 
 Separator:=wdSeparateByCommas, _ 
 Format:=wdTableFormatList8)

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.