Seleciona e retorna um valor de uma lista de argumentos.
Sintaxe
Escolha( index , choice-1 [, choice-2] ... [, choice-n] )
A sintaxe escolher função tem esses argumentos:
Argumento |
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 variant que contém uma das opções possíveis. |
Comentários
Escolha retorna um valor da lista de opções com base no valor do índice. Se o índice for 1, Escolha retorna a primeira opção na lista; se o índice for 2, ele retornará a segunda opção e assim por diante.
Você pode usar Escolher para pesquisar um valor em uma lista de possibilidades. Por exemplo, se o índice for avaliado como 3 e choice-1 = "one", choice-2 = "two" e choice-3 = "three", escolha retornar "três". Essa funcionalidade será particularmente útil se o índice representar o valor em um grupo de opções.
Escolha avaliar todas as opções da lista, mesmo que ela retorne apenas uma. Por esse motivo, você deve watch para efeitos colaterais indesejáveis. Por exemplo, se você usar a função MsgBox como parte de um expressão em todas as opções, uma caixa de mensagem será exibida para cada escolha conforme ela for avaliada, mesmo que Escolha retorne o valor de apenas uma delas.
A função Escolher retorna um Null se o índice for menor que 1 ou maior do que o número de opções listadas.
Se o índice não for um número inteiro, ele será arredondado para o número inteiro mais próximo antes de ser avaliado.
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; |
Retorna 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; |
Retorna os valores em "DateofSale" e o respectivo nome do mês na coluna "MonthName". (Month(DateofSale) retorna o número do mês do "DateofSale", que é usado como índice para escolher entre a lista de opções na "função Escolher"). |
Exemplo de VBA
Observação: Exemplos a seguir demonstram o uso dessa função em um módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
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