Função ConvCad

Devolve uma Variante (Cadeia) convertida conforme especificado.

Sintaxe

StrConv ( cadeia; conversão [, LCID ] )

A sintaxe da função StrConv tem os seguintes argumentos:

Argumento

Descrição

cadeia

Obrigatório. Expressão de cadeia a converter.

conversão

Obrigatório. Valores. A soma de valores que especifica o tipo de conversão a ser efetuada.

LCID

Opcional. O LocaleID, se for diferente do LocaleID do sistema. (O LocaleID do sistema é a predefinição.)

Definições

As definições deargumento de conversão são:

Constante

Valor

Descrição

vbUpperCase

1

Converte a cadeia em carateres em maiúsculas.

vbLowerCase

2

Converte a cadeia em carateres em minúsculas.

vbProperCase

3

Converte a primeira letra de cada palavra na cadeia em maiúsculas.

vbWide *

2,4

Converte carateres estreitos (de byte único) na cadeia em carateres de largura (byte duplo).

vbNarrow *

8h

Converte carateres de largura (byte duplo) numa cadeia para carateres estreitos (de byte único).

vbKatakana **

16 * *

Converte carateres hiragana em cadeia em carateres katakana.

vbHiragana **

32 * *

Converte carateres katakana em cadeia em carateres hiragana.

vbUnicode

64

Converte a cadeia em Unicode utilizando a página de código predefinida do sistema. (Não está disponível no Macintosh.)

vbFromUnicode

128

Converte a cadeia de Unicode para a página de código predefinida do sistema. (Não está disponível no Macintosh.)

* Aplica-se a localidades do leste asiático.

* * Aplica-se apenas ao Japão.

Nota: Estas constantes são especificadas pelo VBA (Visual Basic for Applications). Como resultado, as mesmas poderão ser utilizadas em qualquer parte do seu código no lugar dos valores reais. A maioria pode ser combinada, por exemplo, vbUpperCase + vbWide, exceto quando são mutuamente exclusivas, por exemplo, vbUnicode + vbFromUnicode. As constantes vbWide, vbNarrow, vbKatakanae vbHiragana causam erros em tempo de execução quando são utilizadas em locais onde não se aplicam.

Seguem-se os separadores de palavras válidos: nulo (Chr$ (0)), separador horizontal (Chr$ (9)), avanço de texto (Chr$ (10)), separador vertical (Chr$ ( 11)), feed de formulário(Chr$ (12)), retorno de carro (Chr$ (13)), espaço (SBCS) (Chr$ (32). O valor real de um espaço varia por país/região para DBCS.

Observações

Quando estiver a converter a partir de uma matriz de bytes em formato ANSI numa cadeia, deve utilizar a função StrConv . Quando estiver a converter a partir de uma matriz em formato Unicode, utilize uma instrução de atribuição.

Exemplos de consulta

Expressão

Resultados

Selecione strConv (ProductDesc, 1) como expr1 a partir de ProductSales;

Converte os valores do campo "ProductDesc" em maiúsculas e são mostrados na coluna expr1

Selecione strConv (ProductDesc; 2) como LowercaseID a partir de ProductSales;

Converte os valores do campo "ProductDesc" em minúsculas e são exibidos na coluna LowercaseID. Converte a primeira letra de cada palavra de "ProductDesc" em maiúsculas e apresenta na coluna PropercaseID. Todos os outros carateres são deixados em letras minúsculas.

Exemplo de VBA

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a função StrConv para converter uma cadeia Unicode numa cadeia ANSI.

Dim i As Long
Dim x() As Byte
x = StrConv("ABCDEFG", vbFromUnicode) ' Convert string.
For i = 0 To UBound(x)
Debug.Print x(i)
Next

Nota:  Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode indicar-nos se estas informações foram úteis? Eis o artigo em inglês para sua referência.​

Consulte Também

As funções de cadeia e como utilizá-las

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×