Visão geral do modelo de objeto do Visio

Artigo
08/08/2011

Para desenvolver soluções do Office Visio do Microsoft Office, você pode interagir com o modelo de objeto do Visio. Esse modelo de objeto consiste de classes e interfaces que são fornecidos no assembly de interoperabilidade primária do Visio e são definidos no Microsoft.Office.Interop.Visio namespace.

Este tópico fornece uma visão geral sobre o modelo de objeto do Visio. Para obter informações sobre como usar o modelo de objeto do Visio para executar tarefas em projetos do Office, consulte os seguintes tópicos:

Compreendendo o modelo de objeto do Visio

O Visio fornece muitos objetos com os quais você pode interagir. Esses objetos são organizados em uma hierarquia de parecido com o da interface do usuário. Na parte superior da hierarquia é a Microsoft.Office.Interop.Visio.Application objeto. Este objeto representa a instância atual do Visio. O Microsoft.Office.Interop.Visio.Application objeto contém o Microsoft.Office.Interop.Visio.Document e Microsoft.Office.Interop.Visio.Page objetos, bem como a Microsoft.Office.Interop.Visio.Documents e Microsoft.Office.Interop.Visio.Pages coleções. Cada um desses objetos e coleções tem vários métodos e propriedades que você pode acessar, manipular e interagir com ele.

Para obter mais informações, consulte a documentação de referência do VBA para Microsoft.Office.Interop.Visio.Application, Microsoft.Office.Interop.Visio.Document, e Microsoft.Office.Interop.Visio.Page objetos e também o Microsoft.Office.Interop.Visio.Documents e Microsoft.Office.Interop.Visio.Pages coleções.

As seguintes seções descrevem brevemente os objetos de nível superior e como eles interagem entre si. Esses objetos incluem os seguintes objetos:

Objeto de aplicativo
Objeto de documento
Objeto de página

Objeto de aplicativo

O Microsoft.Office.Interop.Visio.Application objeto representa o aplicativo Visio e é o pai de todos os outros objetos. Seus membros geralmente se aplicam ao Visio como um todo. Você pode usar as propriedades e métodos para o Microsoft.Office.Interop.Visio.Application e o Microsoft.Office.Interop.Visio.ApplicationSettings objetos para controlar o ambiente do Visio.

No nível do aplicativo add-in de projetos, você pode acessar o Microsoft.Office.Interop.Visio.Application o objeto usando o Application campo o ThisAddIn classe. For more information, see Os suplementos de nível de aplicativo de programação..

Objeto de documento

O Microsoft.Office.Interop.Visio.Document objeto é fundamental para a programação do Visio. Ele representa um desenho, estêncil ou arquivo de modelo. Quando você abre um documento do Visio ou cria um novo documento, crie um novo Microsoft.Office.Interop.Visio.Document objeto, que é adicionado para o Microsoft.Office.Interop.Visio.Documents coleção da Microsoft.Office.Interop.Visio.Application objeto.

O documento que tem o foco é chamado o documento ativo. Ela é representada pelo Microsoft.Office.Interop.Visio.Application.ActiveDocument propriedade da Microsoft.Office.Interop.Visio.Application objeto.

Objeto de página

O Microsoft.Office.Interop.Visio.Page objeto representa a área de desenho de uma página de primeiro plano ou uma página de plano de fundo. Você pode usar o Microsoft.Office.Interop.Visio.Page.Background a propriedade para determinar se uma página é uma página de primeiro plano ou plano de fundo.

Para criar formas, você pode usar os métodos que incluem o Microsoft.Office.Interop.Visio.Page.DrawSpline e Microsoft.Office.Interop.Visio.Page.DrawOval métodos. Além disso, você pode recuperar os mestres de estênceis e colocar as formas em uma página usando o Microsoft.Office.Interop.Visio.Page.Drop ou Microsoft.Office.Interop.Visio.Page.DropMany métodos.

Usando a documentação do modelo de objeto do Visio

Para obter informações completas sobre o modelo de objeto do Visio, consulte a referência de modelo de objeto do Visio VBA. Os VBA objeto modelo documentos de referência o modelo de objeto do Visio como ele é exposto para Visual Basic for Applications o código VBA (). A referência de modelo de objeto do VBA para o Visio está disponível nos seguintes locais:

Todos os objetos e membros na referência de modelo de objeto do VBA correspondem a tipos e membros a assembly de interoperabilidade primária (PIA) do Visio. Por exemplo, o Document o objeto na referência de modelo de objeto do VBA corresponde ao Microsoft.Office.Interop.Visio.Document o tipo de PIA do Visio. Embora a referência de modelo de objeto do VBA fornece exemplos de código para a maioria das propriedades, métodos e eventos, você deve traduzir o código do VBA nesta referência para Visual Basic ou C# Visual se desejar usá-los em um suplemento do projeto do Visio que você criar usando o Visual Studio.

Observação
Neste momento, não há nenhuma documentação de referência para o assembly de interoperabilidade primária do Visio.

Para obter exemplos de código relacionado e ferramentas adicionais para a criação de soluções do Visio, consulte os seguintes downloads:

Tipos adicionais de Assemblies de interoperabilidade primários

Você pode encontrar tipos em assemblies de interoperabilidade primária que não estão visíveis para o VBA causa das diferenças de implementação. VBA fornece um modo de exibição do modelo de objeto do Visio que inclui somente os objetos e membros que você pode usar diretamente. Assemblies de interoperabilidade primários expõem o mesmo modelo de objeto, mas eles também incluem outras interfaces, classes e membros que convertem os objetos no modelo de objeto COM código gerenciado. Esses itens adicionais não se destinam a ser usado diretamente em seu código.

Para obter mais informações, consulte Visão geral das Classes e Interfaces no Office Primary Interop Assemblies e Assemblies de interoperabilidade primária do Office.