Método Range.ConvertToTable (Word)

Converte o texto dentro de um intervalo em uma tabela. Retorna a tabela como um objeto Table.

Sintaxe

expression. ConvertToTable( _Separator_ , _NumRows_ , _NumColumns_ , _InitialColumnWidth_ , _Format_ , _ApplyBorders_ , _ApplyShading_ , _ApplyFont_ , _ApplyColor_ , _ApplyHeadingRows_ , _ApplyLastRow_ , _ApplyFirstColumn_ , _ApplyLastColumn_ , _AutoFit_ , _AutoFitBehavior_ , _DefaultTableBehavior_ )

expressão Uma variável que representa um objeto de Intervalo.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Separator	Opcional	Variant	Especifica o caractere usado para separar o texto nas células. Pode ser um caractere ou uma das seguintes constantes WdTableFieldSeparator. Se esse argumento for omitido, o valor da propriedade DefaultTableSeparator é usado.
NumRows	Opcional	Variant	O número de linhas na tabela. Se esse argumento for omitido, o Microsoft Word definirá o número de linhas com base no conteúdo do intervalo.
NumColumns	Opcional	Variant	O número de colunas na tabela. Se esse argumento for omitido, o Word definirá o número de colunas com base no conteúdo do intervalo.
InitialColumnWidth	Opcional	Variant	A largura inicial de cada coluna, em pontos. Quando esse argumento é omitido, o Word calcula e ajusta a largura da coluna para que a tabela se estenda de margem a margem.
Format	Opcional	Variant	Especifica um dos formatos predefinidos listados na caixa de diálogo Table AutoFormat. Pode ser uma das seguintes constantes WdTableFormat.
ApplyBorders	Opcional	Variant	True para aplicar as propriedades de borda do formato especificado.
ApplyShading	Opcional	Variant	True para aplicar as propriedades de sombreamento do formato especificado.
ApplyFont	Opcional	Variant	True para aplicar as propriedades de fonte do formato especificado.
ApplyColor	Opcional	Variant	True para aplicar as propriedades de cor do formato especificado.
ApplyHeadingRows	Opcional	Variant	True para aplicar as propriedades de linha de título do formato especificado.
ApplyLastRow	Opcional	Variant	True para aplicar as propriedades de última linha do formato especificado.
ApplyFirstColumn	Opcional	Variant	True para aplicar as propriedades de primeira coluna do formato especificado.
ApplyLastColumn	Opcional	Variant	True para aplicar as propriedades de última coluna do formato especificado.
AutoFit	Opcional	Variant	True para diminuir a largura das colunas da tabela tanto quanto possível sem alterar o maneira como o texto é disposto nas células.
AutoFitBehavior	Opcional	Variant	Define as regras de AutoAjuste para como o Word dimensiona uma tabela. Pode ser uma das seguintes constantes WdAutoFitBehavior. Se não for DefaultTableBehavior wdWord8TableBehavior, este argumento será ignorado.
DefaultTableBehavior	Opcional	Variant	Define um valor que especifica se o Microsoft Word redimensiona automaticamente as células em uma tabela para ajustar o conteúdo (ajuste automático). Pode ser uma das constantes WdDefaultTableBehavior.

Valor de retorno

Table

Exemplo

Este exemplo converte os três primeiros parágrafos do documento ativo em uma tabela.

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

Confira também

Objeto Range

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.