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

Seleciona e devolve um valor de uma lista de argumentos.

Sintaxe

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

A sintaxe da função Escolher tem estes argumentos:

Argumento

Descrição

índice

Obrigatório. Expressão numérica ou campo que resulta num valor entre 1 e o número de opções disponíveis.

escolha

Obrigatório. Expressão de variante que contém uma das opções possíveis.

Observações

Escolher devolve um valor da lista de escolhas com base no valor do índice. Se índice for 1, Escolher devolve a primeira opção na lista; Se o índice for 2, devolve a segunda opção e assim sucessivamente.

Pode utilizar Escolher para procurar um valor numa lista de possibilidades. Por exemplo, se o índice for avaliado como 3 e choice-1 = "um", choice-2 = "two" e choice-3 = "three", Choose devolve "three". Esta capacidade é particularmente útil se o índice representar o valor num grupo de opções.

Escolher avalia todas as opções na lista, mesmo que devolva apenas uma. Por este motivo, deve watch para efeitos colaterais indesejáveis. Por exemplo, se utilizar a função MsgBox como parte de um expressão em todas as opções, será apresentada uma caixa de mensagem para cada escolha à medida que for avaliada, apesar de Escolher devolver o valor de apenas uma delas.

A função Escolher devolve um Valor Nulo se o índice for inferior a 1 ou superior ao número de opções listadas.

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

Exemplos de consulta

Expressão

Resultados

SELECT Choose(3,"Jan","Fev","Mar","Abr","Maio","Jun","Jul","Ago","Sep","Out","Nov","Dez") AS Expr1 FROM ProductSales;

Devolve o terceiro valor da lista de valores. Resultado: "Mar".

SELECT DateofSale, Choose(Month(DateofSale),"Jan","Fev","Mar","Abr","May","Jun","Jul","Aug","Sep","Out","Nov","Dec") AS MonthName FROM ProductSales;

Devolve os valores em "DateofSale" e o respetivo nome do mês na coluna "MonthName". (Month(DateofSale) devolve o número do mês de "DateofSale", que é depois utilizado como índice para escolher a partir da lista de opções na "Função Escolher").

Exemplo de VBA

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a função Escolher para apresentar um nome em resposta a um índice transmitido 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 subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.