Метод 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 .

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

Table

Пример

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

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 и обратная связь.