Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

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

Precisa de mais ajuda?

Quer mais opções

Explore os benefícios da assinatura, procure cursos de treinamento, saiba como proteger seu dispositivo e muito mais.

As comunidades ajudam você a fazer e responder perguntas, fazer comentários e ouvir especialistas com conhecimento avançado.