Selection.ConvertToTable-Methode (Word)
Konvertiert Text innerhalb eines Bereichs in eine Tabelle. Gibt die Tabelle als Table-Objekt zurück.
Syntax
Ausdruck. ConvertToTable (Separator, NumRows, NumColumns, InitialColumnWidth, Format, ApplyBorders, ApplyShading, ApplyFont, ApplyColor, ApplyHeadingRow,ApplyLastRow, ApplyFirstColumn, ApplyLastColumn, AutoFit, AutoFitBehavior, DefaultTableBehavior)
Ausdruck Eine Variable, die ein Selection-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| Separator | Optional | Variant | Gibt das zum Teilen von Text in Zellen verwendete Zeichen an. Dies kann ein Zeichen oder eine der nachfolgend aufgeführten WdTableFieldSeparator-Konstanten sein. Wenn dieses Argument nicht angegeben wird, wird der Wert der DefaultTableSeparator-Eigenschaft verwendet. |
| NumRows | Optional | Variant | Die Anzahl der Zeilen in der Tabelle. Wenn dieses Argument weggelassen wird, wird die Anzahl der Zeilen von Microsoft Word entsprechend dem Inhalt des Bereichs festgelegt. |
| NumColumns | Optional | Variant | Die Anzahl der Spalten in der Tabelle. Wenn dieses Argument weggelassen wird, wird die Anzahl der Spalten von Word entsprechend dem Inhalt des Bereichs festgelegt. |
| InitialColumnWidth | Optional | Variant | Die anfängliche Breite jeder Spalte (in Punkt). Wenn dieses Argument nicht angegeben wird, wird die Spaltenbreite von Word berechnet und so angepasst, dass sich die Tabelle von einem Seitenrand zum nächsten erstreckt. |
| Format | Optional | Variant | Gibt eines der vordefinierten Formate an, die im Dialogfeld Tabelle AutoFormat aufgeführt werden. Kann eine der WdTableFormat-Konstanten sein. |
| ApplyBorders | Optional | Variant | True, um die Eigenschaften für den Rahmen des angegebenen Formats zu übernehmen. |
| ApplyShading | Optional | Variant | True, um die Eigenschaften für die Schattierung des angegebenen Formats zu übernehmen. |
| ApplyFont | Optional | Variant | True, um die Eigenschaften für die Schriftart des angegebenen Formats zu übernehmen. |
| ApplyColor | Optional | Variant | True, um die Eigenschaften für die Farbe des angegebenen Formats zu übernehmen. |
| ApplyHeadingRows | Optional | Variant | True, um die Eigenschaften für die Kopfzeile des angegebenen Formats zu übernehmen. |
| ApplyLastRow | Optional | Variant | True, um die Eigenschaften für die letzte Zeile des angegebenen Formats zu übernehmen. |
| ApplyFirstColumn | Optional | Variant | True, um die Eigenschaften für die erste Spalte des angegebenen Formats zu übernehmen. |
| ApplyLastColumn | Optional | Variant | True, um die Eigenschaften für die letzte Spalte des angegebenen Formats zu übernehmen. |
| AutoFit | Optional | Variant | True, wenn die Breite der Tabellenspalten so weit wie möglich verkleinert werden soll, ohne die Art zu ändern, wie der Text in den Zellen umbrochen wird. |
| AutoFitBehavior | Optional | Variant | Legt die AutoAnpassen-Regeln für die Anpassung der Größe einer Tabelle in Word fest. Kann eine der folgenden WdAutoFitBehavior-Konstanten sein. Wenn für DefaultTableBehavior der Wert wdWord8TableBehavior festgelegt ist, wird dieses Argument ignoriert. |
| DefaultTableBehavior | Optional | Variant | Legt einen Wert fest, der angibt, ob die Größe der Zellen in einer Tabelle von Microsoft Word automatisch an die Größe des Inhalts angepasst wird (AutoAnpassen). Kann eine der WdDefaultTableBehavior-Konstanten sein. |
Rückgabewert
Table
Beispiel
In diesem Beispiel wird an der Einfügemarke Text eingefügt und dann der durch Kommata getrennte Text in eine Tabelle mit Formatierung konvertiert.
With Selection
.Collapse
.InsertBefore "one, two, three"
.InsertParagraphAfter
.InsertAfter "one, two, three"
.InsertParagraphAfter
End With
Set myTable = Selection.ConvertToTable( _
Separator:=wdSeparateByCommas, _
Format:=wdTableFormatList8)
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.