Função Choose

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Seleciona e retorna um valor de uma lista de argumentos.

Sintaxe

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

A sintaxe da função Escolher tem os seguintes argumentos:

Argumento

Descrição

índice

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

Escolha

Necessário. Expressão variante que contém uma das opções possíveis.


Comentários

Escolha retorna um valor na lista de opções com base no valor de índice. Se o índice for 1, Escolher retornará a primeira opção na lista; Se o índice for 2, 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 o índice será avaliado como 3 e a opção-1 = "um", Escolha-2 = "dois" e Escolha-3 = "três", Escolher retornará "três". Esse recurso é especialmente útil se índice representa o valor em um grupo de opções.

Escolha avalia todas as opções na lista, mesmo que retorne somente uma. Por esse motivo, você deve ficar atento à lado indesejada. Por exemplo, se você usar a função MsgBox como parte de um expressão em todas as opções, uma caixa de mensagem aparecerá para cada opção como ele é avaliado, apesar de Escolher retornará o valor de apenas uma delas.

A função Escolher retorna um valor nulo se índice for menor que 1 ou maior que o número de opções listadas.

Se index não é um número inteiro, ele será arredondado para o número inteiro mais próximo antes de ser avaliado.

Exemplo

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa 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 ao procedimento no parâmetro Ind .

Function GetChoice(Ind As Integer)
GetChoice = Choose(Ind, "Speedy", "United", "Federal")
End Function

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
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.

×