Seleciona e retorna um valor de uma lista de argumentos.
Sintaxe
Choose(índice , 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. |
Comentários
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 ter em atenção os efeitos colaterais indesejáveis. Por exemplo, se utilizar a função MsgBox como parte de uma 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
Observação
Exemplos que se seguem demonstram a utilização desta função num módulo Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Programador 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 Ind parâmetro .
Function GetChoice(Ind As Integer)
GetChoice = Choose(Ind, "Speedy", "United", "Federal")
End Function