Função IsMissing

Devolve um valor Boolean que indica se uma variante opcionalargumento foi passada para um procedimento.

Sintaxe

IsMissing(argname)

O argumento de argname necessário contém o nome de um argumento de procedimento opcional da Variante.

Observações

Utilize a função IsMissing para detetar se foram ou não fornecidos argumentos de variante opcional na convocação de um procedimento. IsMissing devolve true se não tiver sido passado qualquer valor para o argumento especificado; caso contrário, devolve Falso. Se o IsMissing retornar a True para um argumento, a utilização do argumento em falta noutro código pode causar um erro definido pelo utilizador. Se o IsMissing for utilizado num argumento paramArray, retorna sempre falso. Para detetar um ParamArrayvazio, teste para ver se o limite superior da matriz é inferior ao seu limite inferior.

Nota: O IsMissing não funciona em tipos simples de dados (como o Inteiro ou o Duplo)porque, ao contrário das Variantes,não têm uma provisão para uma parte de bandeira "em falta". Por isso, a sintaxe para argumentos opcionais dactilografado permite especificar um valor padrão. Se o argumento for omitido quando o procedimento for chamado, então o argumento terá este valor padrão, como no exemplo abaixo:

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.

Sub MySub(Optional MyVar As String = "specialvalue")
If MyVar = "specialvalue" Then
' MyVar was omitted.
Else
...
End Sub

Em muitos casos, pode omitir o If MyVar testar inteiramente, tornando o valor predefinido igual ao valor que pretende MyVar conter se o utilizador omitir da chamada de função. Isto torna o seu código mais conciso e eficiente.

Exemplo

Este exemplo utiliza a função IsMissing para verificar se um argumento opcional foi passado para um procedimento definido pelo utilizador. Note que os argumentos opcionais podem agora ter valores e tipos padrão que não a Variante.

Dim ReturnValue
' The following statements call the user-defined
' function procedure.
ReturnValue = ReturnTwice() ' Returns Null.
ReturnValue = ReturnTwice(2) ' Returns 4.
' Function procedure definition.
Function ReturnTwice(Optional A)
If IsMissing(A) Then
' If argument is missing, return a Null.
ReturnTwice = Null
Else
' If argument is present, return twice the value.
ReturnTwice = A * 2
End If
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