Range.ConvertToTable, méthode (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 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
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.