Compartilhar via


Definir referências às bibliotecas de tipos

Ao definir uma referência à biblioteca de tipos de outro aplicativo, você pode usar no código os objetos fornecidos por esse aplicativo. Por exemplo, se você definir uma referência do Access para a biblioteca do Excel, poderá usar objetos do Excel por meio da Automação (anteriormente chamada de Automação OLE). Se você definir uma referência a um projeto do Visual Basic em outro banco de dados do Access, poderá chamar seus procedimentos públicos. Se você definir uma referência a um controle ActiveX, poderá usar esse controle em formulários de acesso.

Você pode definir uma referência do Access enquanto o Editor do Visual Basic estiver aberto ou definir uma referência no código do Visual Basic.

Definir uma referência do Access

Para definir uma referência à biblioteca de tipos de um aplicativo:

  1. No menu Ferramentas , selecione Referências. O comando Referências do menu Ferramentas só estará disponível quando uma janela Módulo estiver aberta e ativa no modo de design.

  2. Marque as caixas de seleção dos aplicativos a cujas bibliotecas de tipos você deseja fazer referência.

Definir uma referência do Visual Basic

Para definir uma referência do Visual Basic, crie um novo objeto Reference representando a referência desejada. A coleção Referências contém todas as referências definidas no momento.

Para criar um novo objeto Reference , use o método AddFromFile ou AddFromGUID da coleção References . Para remover um objeto Reference, use o método Remove.

Vantagens das referências de configuração

O seu código de Automação será executado com maior velocidade se você definir uma referência à biblioteca de tipos de um outro aplicativo antes de trabalhar com seus objetos. Se você definiu uma referência, pode declarar uma variável de objeto que represente um objeto no outro aplicativo como seu tipo mais específico.

Por exemplo, se você estiver escrevendo código para trabalhar com objetos do Excel, poderá declarar uma variável de objeto do tipo Excel.Application usando a seguinte sintaxe somente se você tiver criado uma referência à biblioteca de tipos do Excel:

Dim appXL As New Excel.Application

Se você não tiver definido uma referência para a biblioteca de tipos do Excel, deverá declarar a variável como uma variável genérica do tipo Objeto. O código a seguir é executado mais lentamente:

Dim appXL As Object

Adicionalmente, se você definir uma referência à biblioteca de tipos de um aplicativo, todos os seus objetos, bem como seus métodos e propriedades, estarão listados no Pesquisador de Objetos. Isso torna mais fácil determinar quais propriedades e métodos estão disponíveis para cada objeto.

Como o Access é um componente COM que dá suporte à automação, você também pode definir uma referência à biblioteca de tipos de outro aplicativo e trabalhar com objetos Access desse aplicativo.

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.