Instrução Enum

Declara um tipo para uma enumeração.

Sintaxe

[ Público | Privado ] Nome do nome de enum [= constantexpression ] nome do membro [= constantexpressão ] . . . .Enumeração de Fim

A instrução Enum tem as seguintes partes:

Sair	Descrição
Public	Opcional. Especifica que o tipo de Enumeração é visível em todo o projeto. Os tipos de enumeração são Públicos por predefinição.
Private	Opcional. Especifica que o tipo de Enumeração é visível apenas no módulo em que aparece.
name	Obrigatório. O nome do tipo Enum . O nome tem de ser um identificador do Visual Basic válido e é especificado como o tipo ao declarar variáveis ou parâmetros do tipo Enum .
nome do membro	Obrigatório. Um identificador do Visual Basic válido que especifica o nome pelo qual será conhecido um elemento constituinte do tipo Enum .
constantexpressão	Opcional. Valor do elemento (avaliado como Longo). Se não for especificada nenhuma constantexpressão , o valor atribuído é zero (se for o primeiro nome de membro ) ou 1 maior do que o valor do nome de membro imediatamente anterior.

Comentários

As variáveis de enumeração são variáveis declaradas com um tipo de Enumeração . As variáveis e os parâmetros podem ser declarados com um tipo de Enumeração . Os elementos do tipo Enumeração são inicializados para valores constantes na instrução Enumeração . Os valores atribuídos não podem ser modificados no tempo de execução e podem incluir números positivos e negativos. Por exemplo:

Enum SecurityLevel 
 IllegalEntry = -1 
 SecurityLevel1 = 0 
 SecurityLevel2 = 1 
End Enum 

Uma instrução Enum só pode aparecer ao nível do módulo. Depois de o tipo de Enumeração ser definido, pode ser utilizado para declarar variáveis, parâmetros ou procedimentos que devolvem o respetivo tipo. Não pode qualificar um nome de tipo de Enumeração com um nome de módulo.

Os tipos de Enumeração Pública num módulo de classe não são membros da classe; no entanto, são escritas na biblioteca de tipos. Os tipos de enumeraçãodefinidos em módulos padrão não são escritos em bibliotecas de tipo. Os tipos de Enumeração Pública com o mesmo nome não podem ser definidos em módulos padrão e módulos de classe porque partilham o mesmo espaço de nomes. Quando dois tipos de Enumeração em bibliotecas de tipos diferentes têm o mesmo nome, mas elementos diferentes, uma referência a uma variável do tipo depende da biblioteca de tipos que tem maior prioridade nas Referências.

Não pode utilizar um tipo de Enumeração como destino num bloco Com .

Exemplo

O exemplo seguinte mostra a instrução Enum utilizada para definir uma coleção de constantes nomeadas. Neste caso, as constantes são cores que pode optar por criar formulários de introdução de dados para uma base de dados.

Public Enum InterfaceColors 
 icMistyRose = &HE1E4FF& 
 icSlateGray = &H908070& 
 icDodgerBlue = &HFF901E& 
 icDeepSkyBlue = &HFFBF00& 
 icSpringGreen = &H7FFF00& 
 icForestGreen = &H228B22& 
 icGoldenrod = &H20A5DA& 
 icFirebrick = &H2222B2& 
End Enum

Confira também

• Tipos de dados
• Instruções

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.