Метод Range.ConvertToTable (Word)

Преобразует текст в диапазоне в таблицу. Возвращает таблицу в виде объекта Table .

Синтаксис

выражение. ConvertToTable( _Separator_ , _NumRows_ , _NumColumns_ , _InitialColumnWidth_ , _Format_ , _ApplyBorders_ , _ApplyShading_ , _ApplyFont_ , _ApplyColor_ , _ApplyHeadingRows_ , _ApplyLastRow_ , _ApplyFirstColumn_ , _ApplyLastColumn_ , _AutoFit_ , _AutoFitBehavior_ , _DefaultTableBehavior_ )

выражение: переменная, представляющая объект Range.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Separator	Необязательный	Variant	Указывает символ, используемый для разделения текста на ячейки. Может быть символом или одной из следующих констант WdTableFieldSeparator . Если этот аргумент опущен, используется значение свойства DefaultTableSeparator .
NumRows	Необязательный	Variant	Количество строк в таблице. Если этот аргумент опущен, Microsoft Word задает количество строк на основе содержимого диапазона.
NumColumns	Необязательный	Variant	Количество столбцов в таблице. Если этот аргумент опущен, Word задает количество столбцов на основе содержимого диапазона.
InitialColumnWidth	Необязательный	Variant	Начальная ширина каждого столбца в точках. Если этот аргумент опущен, Word вычисляет и настраивает ширину столбца таким образом, чтобы таблица растягивалась от поля к краю.
Format	Необязательный	Variant	Задает один из стандартных форматов, перечисленных в диалоговом окне Автоформат таблицы . Может быть одной из констант WdTableFormat .
ApplyBorders	Необязательный	Variant	Значение true , чтобы применить свойства границы указанного формата.
ApplyShading	Необязательный	Variant	Значение true , чтобы применить свойства затенения указанного формата.
ApplyFont	Необязательный	Variant	Значение true для применения свойств шрифта указанного формата.
ApplyColor	Необязательный	Variant	Значение true , чтобы применить свойства цвета указанного формата.
ApplyHeadingRows	Необязательный	Variant	Значение true для применения свойств строки заголовка указанного формата.
ApplyLastRow	Необязательный	Variant	Значение true , чтобы применить свойства последней строки указанного формата.
ApplyFirstColumn	Необязательный	Variant	Значение true для применения свойств первого столбца указанного формата.
ApplyLastColumn	Необязательный	Variant	Значение true , чтобы применить свойства последнего столбца указанного формата.
AutoFit	Необязательный	Variant	Значение true , чтобы максимально уменьшить ширину столбцов таблицы, не изменяя способ переноса текста в ячейки.
AutoFitBehavior	Необязательный	Variant	Задает правила автоподбора для Word размера таблицы. Может быть одной из следующих констант WdAutoFitBehavior . Если defaultTableBehavior имеет значение wdWord8TableBehavior, этот аргумент игнорируется.
DefaultTableBehavior	Необязательный	Variant	Задает значение, указывающее, будет ли Microsoft Word автоматически изменять размер ячеек в таблице в соответствии с содержимым (Автоподбор). Может быть одной из констант WdDefaultTableBehavior .

Возвращаемое значение

Таблица

Пример

В этом примере первые три абзаца активного документа преобразуются в таблицу.

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

См. также

Объект Range

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.