Usar constantes

  • Artigo

Seu código pode conter valores constantes frequentes ou pode depender de determinados números que são difíceis de lembrar e não têm nenhum significado óbvio. Você pode facilitar a leitura e a manutenção do código usando constantes. Uma constante é um nome significativo que toma o lugar de um número ou cadeia de caracteres que não é alterado. Você não pode modificar uma constante ou atribuir um novo valor a ela, pois pode ser uma variável.

Tipos de constantes

Há três tipos de constantes:

  • Constantes intrínsecas ou constantes definidas pelo sistema são fornecidas por aplicativos e controles. Outros aplicativos que fornecem bibliotecas de objetos, como Microsoft Access, Excel, Project e Word também fornecem uma lista de constantes que você pode usar com seus objetos, métodos e propriedades. Você pode obter uma lista das constantes fornecidas para bibliotecas de objetos individuais no Navegador de Objetos.

    As constantes do Visual Basic estão listadas na biblioteca de tipos Visual Basic for Applications e na biblioteca de DAO (Objeto de Acesso de Dados).

    Observação

    O Visual Basic continua reconhecendo constantes em aplicativos criados em versões anteriores do Visual Basic ou Visual Basic for Applications. Você pode atualizar suas constantes para aquelas listadas no Navegador de Objetos. As constantes listadas no Navegador de Objetos não precisam ser declaradas em seu aplicativo.

  • Constantes simbólicas ou definidas pelo usuário são declaradas usando a instrução Const .

  • As constantes do compilador condicional são declaradas usando a instrução #Const (diretiva).

Em versões anteriores do Visual Basic, os nomes constantes geralmente eram capitalizados com sublinhados. Por exemplo:

TILE_HORIZONTAL

As constantes intrínsecas agora são qualificadas para evitar confusão quando há constantes com o mesmo nome em mais de uma biblioteca de objetos, que podem ter valores diferentes atribuídos a elas. Há duas maneiras de qualificar nomes constantes:

  • Por prefixo
  • Por referência de biblioteca

Constantes de qualificação por prefixo

As constantes intrínsecas fornecidas por todos os objetos aparecem em um formato misto, com um prefixo de 2 caracteres indicando a biblioteca de objetos que define a constante. As constantes da biblioteca de objetos Visual Basic for Applications são prefiguradas com "vb" e as constantes da biblioteca de objetos do Microsoft Excel são precedidas de "xl". Os exemplos a seguir ilustram como os prefixos para controles personalizados variam, dependendo da biblioteca de tipos.

  • vbTileHorizontal
  • xlDialogBorder

Qualificação de constantes por referência de biblioteca

Você também pode qualificar a referência a uma constante usando a sintaxe a seguir.

[ libname.] [ modulename.] constname

A sintaxe das constantes de qualificação tem estas partes:

Sair Descrição
nomedabiblioteca Opcional. O nome da biblioteca de tipos que define a constante. Para a maioria dos controles personalizados (não disponíveis no Macintosh), este também é o nome da classe do controle. Se você não se lembrar do nome da classe do controle, posicione o ponteiro do mouse sobre o controle na caixa de ferramentas. O nome da classe é exibido na Dica de Ferramenta.
Modulename Opcional. O nome do módulo dentro da biblioteca de tipos que define a constante. Você pode encontrar o nome do módulo usando o Navegador de Objetos.
constname O nome definido para a constante na biblioteca de tipos.

Por exemplo:

Threed.LeftJustify

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.