Função escolher

  • Artigo

Seleciona e retorna um valor em uma lista de argumentos.

Sintaxe

Escolha(índice, opção-1, [ opção 2, ... , [ opção-n ]])

A sintaxe da função Escolher tem as seguintes partes:

Parte Descrição
índice Obrigatório. Expressão numérica ou campo que resulta em um valor entre 1 e o número de opções disponíveis.
opção Obrigatório. Expressão do tipo Variant contendo uma das opções possíveis.

Comentários

Escolher retorna um valor na lista de opções com base no valor do índice. Se o índice for 1, Escolher a primeira opção retornará na lista; se o índice for 2, retornará a segunda opção e assim por diante.

Use Escolha para pesquisar um valor em uma lista de possibilidades. Por exemplo, se o índice resulta em 3 e opção-1 = "um" opção 2 = "dois", e opção 3 = "três" Escolher retornará "três". Esse recurso é particularmente útil se oíndice representar o valor em um grupo de opções.

Escolher avalia cada opção na lista, mesmo que retorne apenas uma. Por esse motivo, você deve ter cuidado com efeitos colaterais indesejados. Por exemplo, se você usar a função MsgBox como parte de uma expressão em todas as opções, uma caixa de mensagem será exibida para cada opção quando ela for avaliada, mesmo se Choose retornar o valor de apenas uma delas.

A função Escolher retorna Nulo se o índice for menor que 1 ou maior que o número de opções listadas.

Se índice não for um número inteiro, será arredondado para o número inteiro mais próximo antes de ser avaliado.

Exemplo

Este exemplo usa a função Escolher para exibir um nome em resposta a um índice passado para o procedimento no parâmetro Ind.

Function GetChoice(Ind As Integer)
    GetChoice = Choose(Ind, "Speedy", "United", "Federal")
End Function

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.