Função Choose

Seleciona e retorna um valor de uma lista de argumentos.

Sintaxe

Escolha ( índice , opção-1 [, opção-2]... [, opção-n] )

A sintaxe da função escolher tem os seguintes 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 variante 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 índice for 1, escolher retornará 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 índice for avaliado como 3 e opção-1 = "um", opção-2 = "dois" e opção-3 = "3", escolha retornará "três". Essa funcionalidade é particularmente útil se o índice representa o valor em um grupo de opções.

Escolha avaliará todas as opções na lista, mesmo que ela retorne apenas uma. Por esse motivo, você deve observar efeitos colaterais indesejáveis. Por exemplo, se você usar a função CaixaDeMensagem como parte de uma expressão em todas as opções, uma caixa de mensagem será exibida para cada opção conforme é avaliada, mesmo que escolha retorne o valor de apenas uma delas.

A função escolher retornará um índice nulo se o índice for menor que 1 ou maior 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

Selecione escolher (3, "Jan", "fev", "Jul", "ago", "setembro", "Jun", "Jul", "ago", "setembro", "Oct", "Nov", "DEC", "setembro", "setembro", "Outubro"

Retorna o terceiro valor da lista de valores. Resultado: "mar".

Selecione DateofSale, escolha (mês (DateofSale), "Jan", "Jun", "Jul", "ago", "maio", "Jun", "Jul", "agosto", "setembro", "setembro", "Nov", "DEC", "setembro", "setembro", "setembro", "Nov", "DEC",

Retorna os valores em "DateofSale" e o respectivo nome de mês na coluna "Nomedemês". (Month (DateofSale) retorna o número do mês do "DateofSale", que é usado como índice para escolher uma lista de opções na lista "escolher função").

Exemplo de VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). 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

Observação:  Esta página foi traduzida automaticamente e pode apresentar erros gramaticais ou imprecisões. Nosso objetivo é que este conteúdo seja útil para você. Você pode nos dizer se as informações foram úteis? Use o artigo em inglês como referência.​

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×