Compartilhar via

Sobre a biblioteca de tipos do Visio

  • Artigo

Os produtos do Visio incluem uma biblioteca de tipos que define os objetos, propriedades, métodos, eventos e constantes que o Visio expõe aos clientes de Automação. Para usar a biblioteca de tipos do Visio, um ambiente de desenvolvimento deve referenciá-la. O projeto de Visual Basic for Applications (VBA) de um documento do Visio faz referência automaticamente à biblioteca de tipos do Visio. Em outros ambientes de desenvolvimento, você deve seguir as etapas apropriadas para referenciar a biblioteca.

Os nomes das bibliotecas que seu projeto VBA referencia são exibidos na lista Projeto/Biblioteca do Pesquisador de Objeto no Editor do Visual Basic.

Benefícios da utilização de uma biblioteca de tipos

Uma biblioteca de tipos é útil pelos motivos a seguir.

  • As informações em uma biblioteca de tipos servem como entrada para pesquisadores de objeto fornecidos pelo VBA e outros ambientes de desenvolvimento. Use navegadores de objeto para exibir descrições de objetos fornecidos por servidores de Automação (como o aplicativo Visio) instalados em seu sistema. Por exemplo, você pode exibir a sintaxe de uma propriedade, método ou evento do Visio e colar no seu programa o código mostrado pelo pesquisador.

  • Uma biblioteca de tipos permite que ambientes de desenvolvimento liguem o código do seu programa ao código do servidor de automação no momento da compilação (criação) e não dinamicamente em tempo de execução. O resultado é que muitas vezes seu programa é executado mais rápido. Por exemplo, você pode usar Visio.Page, Visio.Shape, Visio.Document e assim por diante em vez de Object.

Resolvendo ambiguidades em nomes de objetos

O projeto do VBA ou o programa Visual Basic podem fazer referência a várias bibliotecas de tipos. Às vezes, as bibliotecas declaram itens com o mesmo nome. Por exemplo, o Visio e o Excel expõem um objeto chamado Aplicativo. Quando mais de uma biblioteca declara um item com o mesmo nome, o VBA e o Visual Basic ligam o nome à biblioteca com a prioridade mais alta.

Uma maneira de resolver ambiguidades em nomes é acrescentar um prefixo aos tipos de objetos com o nome da biblioteca correspondente. Por exemplo:

Dim vsoApplication As Visio.Application 
Dim xlApplication As Excel.Application

Se o seu código for executado exclusivamente no contexto de um projeto VBA ou de um documento do Visio, não será necessário acrescentar prefixos Visio aos nomes dos tipos de objetos do Visio, embora isso seja uma boa ideia. Se você o fizer, a biblioteca de tipos do Visio terá uma prioridade mais alta que as outras bibliotecas que podem declarar nomes conflitantes. O VBA não permite que você altere a prioridade da biblioteca de tipos do Visio quando estiver usando o VBA no Visio, mas em outros ambientes de desenvolvimento você pode alterar a prioridade da biblioteca de tipos do Visio.

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.