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