Choose Function

Retorna um valor selecionado a partir de uma lista de argumentos.

Sintaxe:


  Choose (Index As Integer, Expression1[, Expression2, ... [, Expression_n]]) As Variant

Valor de retorno:

Variant. A value inferred from the Index parameter.

Parâmetros:

Index: Any numeric expression rounded to a whole number. Index accepts integer values starting at 1 that specify which of the possible choices to return.

Expression1, Expression2, …, Expression_n: Expressions representing each of the possible choices.

A função Choose retorna um valor de uma lista de expressões baseado no valor do índice. Se Index = 1, a função retorna a primeira expressão na lista, se Index = 2, a função retorna a segunda expressão, e assim por diante.

If the index value is less than 1 or greater than the number of expressions listed, the function returns a Null value.

Error #5 occurs when parameters are omitted. Error #13 occurs if Index equals Null.

Códigos de erro:

5 Chamada de procedimento inválida

13 Tipo de dados incompatível

Exemplo:

The following example uses the or Choose function to select a string from several strings that form a menu:


Sub ExampleChoose
    Print ChooseMenu(2) ' "Save Format"
    MsgBox Choose(index :=  -5, 9, "Basic", PI) ' Null
    MsgBox Choose(index := 3.14, 9, "Basic", PI) ' PI
End Sub
 
Function ChooseMenu(Index As Integer)
    ChooseMenu = Choose(Index, "Formatação rápida", "Formato de gravação", "Formato do sistema")
End Function