Método Range.TextToColumns (Excel)
Analisa uma coluna de células que contêm texto em várias colunas.
Sintaxe
expressão. TextToColumns (Destination, DataType, TextQualifier, ConsecutiveDelimiter, Tab, Semicolon, Comma, Space, Other, OtherChar, FieldInfo, DecimalSeparator, ThousandsSeparator, TrailingMinusNumbers)
expressão Uma variável que representa um objeto de Intervalo.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Destination | Opcional | Variantes | Um objeto Range que especifica onde o Microsoft Excel colocará os resultados. Se o intervalo for maior do que uma única célula, a célula superior esquerda será usada. |
| DataType | Opcional | XlTextParsingType | O formato do texto a ser dividido em colunas. |
| TextQualifier | Opcional | XlTextQualifier | Especifica se deve usar aspas simples, duplas ou não como o qualificador de texto. |
| ConsecutiveDelimiter | Opcional | Variantes | True para que o Excel considere delimitadores consecutivos como um delimitador. O valor padrão é False. |
| Tab | Opcional | Variant | True para ter DataType como xlDelimited e para ter o caractere de tabulação como um delimitador. O valor padrão é False. |
| Semicolon | Opcional | Variant | True para ter DataType como xlDelimited e para ter o ponto-e-vírgula como um delimitador. O valor padrão é False. |
| Comma | Opcional | Variant | True para ter DataType como xlDelimited e para ter a vírgula como um delimitador. O valor padrão é False. |
| Space | Opcional | Variant | True para ter DataType como xlDelimited e para ter o caractere de espaço como um delimitador. O valor padrão é False. |
| Other | Opcional | Variant | True para ter DataType como xlDelimited e para ter o caractere especificado pelo argumento OtherChar como um delimitador. O valor padrão é False. |
| OtherChar | Opcional | Variantes | Necessário se o Outro for True; o caractere delimitador quando Outro é True. Se mais de um caractere for especificado, somente o primeiro caractere da cadeia de caracteres será usado; os caracteres restantes será ignorado. |
| FieldInfo | Opcional | Variant | Uma matriz com informações de análise para colunas de dados individuais. A interpretação depende do valor do DataType. Quando os dados forem delimitados, esse argumento será uma matriz de matrizes de dois elementos, com cada matriz de dois elementos especificando as opções de conversão para uma coluna em particular. O primeiro elemento é o número de coluna (baseado em 1) e o segundo elemento é uma das constantes XlColumnDataType especificando como a coluna é analisada. |
| DecimalSeparator | Opcional | Variant | O separador decimal que o Microsoft Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema. |
| ThousandsSeparator | Opcional | Variant | O separador de milhares que o Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema. |
| TrailingMinusNumbers | Opcional | Variant | Números que começam com um sinal de menos. |
Valor de retorno
Variant
Comentários
A tabela a seguir mostra os resultados da importação de texto para o Excel para diversas configurações de importação. Os resultados numéricos são exibidos na coluna mais à direita.
| Separador do sistema decimal | Separador de milhares do sistema | Valor do separador decimal | Valor do separador de milhares | Texto original | Valor da célula (tipo de dados) |
|---|---|---|---|---|---|
| Period | Ponto | Ponto | Ponto | 123,123.45 | 123.123,45 (numérico) |
| Ponto | Ponto | Ponto | Ponto | 123,123.45 | 123.123,45 (texto) |
| Ponto | Ponto | Ponto | Ponto | 123,123.45 | 123.123,45 (numérico) |
| Ponto | Ponto | Ponto | Ponto | 123 123,45 | 123 123,45 (texto) |
| Ponto | Ponto | Ponto | Espaço | 123 123,45 | 123.123,45 (numérico) |
Use a constante xlEMDFormat da enumeração XlColumnDataType somente se o suporte ao idioma taiwanês estiver instalado e selecionado. A constante xlEMDFormat especifica que datas da era taiwanesa estão sendo usadas.
Os especificadores de coluna podem estar em qualquer ordem. Se um determinado especificador de coluna não estiver presente para uma coluna específica nos dados de entrada, a coluna será analisada com a configuração xlGeneralFormat . Este exemplo faz com que a terceira coluna seja ignorada, a primeira coluna seja analisada como texto e as colunas restantes nos dados de origem sejam analisadas com a configuração xlGeneralFormat.
Array(Array(3, 9), Array(1, 2))
Se os dados de origem tiverem colunas de largura fixa, o primeiro elemento de cada matriz de dois elementos especificará a posição do caractere inicial na coluna (como um inteiro; 0 (zero) é o primeiro caractere). O segundo elemento da matriz de dois elementos especifica a opção de análise da coluna como um número de 1 a 9, conforme listado anteriormente.
O exemplo a seguir analisa duas colunas de um arquivo de largura fixa, com a primeira coluna desde o início da linha e se estendendo por 10 caracteres. A segunda coluna começa na posição 15 e prossegue até o fim da linha. Para evitar a inclusão dos caracteres entre a posição 10 e a posição 15, o Microsoft Excel adiciona uma entrada de coluna ignorada.
Array(Array(0, 1), Array(10, 9), Array(15, 1))
Exemplo
Este exemplo converte o conteúdo da Área de transferência, uma tabela de texto delimitado por espaço, em colunas separadas na Planilha1. Você pode criar uma tabela simples delimitada no Bloco de Notas ou no WordPad (ou em outro editor de texto), copiar a tabela de texto para a Área de Transferência, alternar para o Microsoft Excel e executar esse exemplo.
Worksheets("Sheet1").Activate
ActiveSheet.Paste
Selection.TextToColumns DataType:=xlDelimited, _
ConsecutiveDelimiter:=True, Space:=True
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.