Função IsObject

  • Artigo

Devolve um valor Booleano que indica se um identificador representa uma variável de objeto.

Sintaxe

IsObject(identificador)

O argumentoidentificador necessário é um nome de variável.

Comentários

IsObject é útil apenas para determinar se uma Variante é de VarType vbObject. Isto pode ocorrer se a Variante fizer referência (ou uma vez referenciada) a um objeto ou se não contiver Nada.

IsObject devolve Verdadeiro se o identificador for uma variável declarada com o Tipo de objeto ou qualquer tipo de classe válido, ou se o identificador for uma Variante de VarType vbObject ou um objeto definido pelo utilizador; caso contrário, devolve Falso.

IsObject devolve Verdadeiro mesmo que a variável tenha sido definida como Nada. Utilize a interceção de erros para se certificar de que uma referência de objeto é válida.

Observação

Esta função é útil nas secções de processamento de erros do código em que não tem a certeza se um objeto foi instanciado antes de o erro ocorrer e, por exemplo, pretende fechá-lo.

Exemplo

Este exemplo utiliza a função IsObject para determinar se um identificador representa uma variável de objeto. MyObject e YourObject são variáveis de objeto do mesmo tipo. São nomes genéricos utilizados apenas para fins de ilustração.

Dim MyInt As Integer              ' Declare variables.
Dim YourObject, MyCheck           ' Note: Default variable type is Variant.
Dim MyObject As Object
Set YourObject = MyObject         ' Assign an object reference.
MyCheck = IsObject(YourObject)    ' Returns True.
MyCheck = IsObject(MyInt)         ' Returns False.
MyCheck = IsObject(Nothing)       ' Returns True.
MyCheck = IsObject(Empty)         ' Returns False.
MyCheck = IsObject(Null)          ' Returns False.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.