Função Escolha

Devolve um valor de uma lista de argumentos.

Sintaxe

Choose(index, choice-1 [, choice-2] ... [, choice-n])

A Choose função tem estes argumentos:

Argumento	Descrição
index	Obrigatório. Uma expressão numérica ou campo que resulta num valor entre 1 e o número de escolhas disponíveis.
choice	Obrigatório. Uma expressão variante que contém uma das escolhas possíveis.

Comentários

Choose Devolve um valor da lista de opções baseadas no valor de index. Se index for 1, Choose devolve a primeira escolha na lista. Se index for 2, devolve a segunda opção e assim sucessivamente.

Pode utilizar Choose para procurar um valor numa lista de possibilidades. Por exemplo, se index for avaliado como 3 e choice-1 = "um", choice-2 = "dois" e choice-3 = "três", Choose devolve "três". Esse comportamento é útil quando index representa o valor em um grupo de opções.

Choose Avalia cada escolha na lista, apesar de devolver apenas uma. Devido a esse comportamento, preste atenção aos efeitos colaterais indesejados. Por exemplo, se utilizar a MsgBox função como parte de uma expressão em todas as escolhas, o Access apresenta uma caixa de mensagem para cada escolha à medida que as avalia, apesar Choose de devolver o valor de apenas uma escolha.

A Choose função devolve Null se index for menor do que 1 ou maior do que o número de escolhas listadas.

Se index não for um número inteiro, o Access arredonda-o para o número inteiro mais próximo antes de o avaliar.

Exemplos de consulta

Expressão	Resultados
SELECT Choose(3,"Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec") AS Expr1 FROM ProductSales;	Devolve o terceiro valor da lista de valores. Resultado: "Mar".
SELECT DateofSale, Choose(Month(DateofSale),"Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec") AS MonthName FROM ProductSales;	Devolve os valores e DateofSale o nome do mês correspondente na MonthName coluna. Month(DateofSale) Devolve o número do mês de DateofSale, e Choose utiliza esse número como o índice para a lista de opções.

Exemplo do VBA

Este exemplo usa a Choose função para exibir um nome para um índice que o procedimento passa no Ind parâmetro.

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