ConvertToText Method

See Also         Example         Applies To

Converts a table to text and returns a Range object that represents the delimited text.

Syntax

expression.ConvertToText(Separator, NestedTables)

expression   Required. An expression that returns a Row, Rows, or Table object.

Separator   Optional Variant. The character that delimits the converted columns (paragraph marks delimit the converted rows). Can be one of the following WdTableFieldSeparator constants: wdSeparateByCommas, wdSeparateByDefaultListSeparator, wdSeparateByParagraphs, or wdSeparateByTabs. The default value is wdSeparateByTabs.

NestedTables   Optional Variant. True if nested tables are converted to text. This argument is ignored if Separator is not wdSeparateByParagraphs. The default value is True.

Remarks

When you apply the ConvertToText method to a Table object, the object is deleted. To maintain a reference to the converted contents of the table, you must assign the Range object returned by the ConvertToText method to a new object variable. In the following example, the first table in the active document is converted to text and then formatted as a bulleted list.

Set myTable = ActiveDocument.Tables(1)
Set aRange = _
    myTable.ConvertToText(Separator:=wdSeparateByParagraphs)
aRange.ListFormat.ApplyListTemplate ListTemplate:=ListGalleries( _
    wdBulletGallery).ListTemplates(1)