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.