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
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.