Range.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_ , _ApplyHeadingRows_ , _ApplyLastRow_ , _ApplyFirstColumn_ , _ApplyLastColumn_ , _AutoFit_ , _AutoFitBehavior_ , _DefaultTableBehavior_ )

Ausdruck Eine Variable, die ein Range-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

Tabelle

Beispiel

In diesem Beispiel werden die ersten drei Absätze im aktiven Dokument in eine Tabelle konvertiert.

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

Siehe auch

Range-Objekt

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.