Função Escolha

Seleciona e devolve um valor de uma lista de argumentos.

Sintaxe

Escolha( índice, escolha-1 [, escolha-2] ... [, escolha-n] )

A sintaxe da função Escolha 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 variante contendo uma das escolhas possíveis.


Observações

Escolha devoluções de um valor da lista de escolhas com base no valor do índice. Se o índice for 1, escolha devolve a primeira escolha da lista; se o índice é 2, devolve a segunda escolha, e assim por diante.

Pode utilizar Escolha procurar um valor numa lista de possibilidades. Por exemplo, se o índice avaliar a 3 e a escolha-1 = "um", escolha-2 = "dois", e escolha-3 = "três", escolha devolve "três". Esta capacidade é particularmente útil se o índice representar o valor num grupo de opções.

Escolha avalia todas as escolhas da lista, mesmo que retorne apenas uma. Por esta razão, deve ter cuidado com efeitos colaterais indesejáveis. Por exemplo, se utilizar a função MsgBox como parte de uma expressão em todas as escolhas, será apresentada uma caixa de mensagens para cada escolha à medida que for avaliada, mesmo que a Choose devolva o valor de apenas uma delas.

A função Escolha devolve um Nulo se o índice for inferior a 1 ou superior ao número de escolhas listadas.

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

Exemplos de consulta

Expressão

Resultados

SELECIONE Escolha(3,"jan","Feb","Mar","abr","May","jun","jul","Aug","set","Oct","nov","Dec") AS Expr1 FROM ProductSales;

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

SELECIONE Datas deVenda, Escolha (Mês (DataofSale),"jan","Feb","Mar","Apr","May","jun","jul","Aug","Sep","Oct","nov","Dec") AS MonthName FROM ProductSales;

Devolve os valores em "DataofSale" e o respetivo nome mensal na coluna "MonthName". (Mês(DataofSale) devolve o número mensal da "DataofSale", que é depois utilizada como índice para escolher entre a lista de escolhas na "função Escolher").

Exemplo 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?

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

×