Partilhar via


Visão geral do modelo de objeto do Visio

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

Este tópico fornece uma breve visão geral do 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:

Compreender 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 que acompanha de perto a interface do usuário. Na parte superior da hierarquia está o objeto Microsoft.Office.Interop.Visio.Application . Este objeto representa a instância atual do Visio. O Microsoft.Office.Interop.Visio.Application objeto contém os Microsoft.Office.Interop.Visio.Document objetos e bem como as Microsoft.Office.Interop.Visio.Documents coleções e Microsoft.Office.Interop.Visio.Pages Microsoft.Office.Interop.Visio.Page . Cada um desses objetos e coleções tem muitos métodos e propriedades que você pode acessar para 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 objetos Microsoft.Office.Interop.Visio.Page, e também as coleções Microsoft.Office.Interop.Visio.Documents e Microsoft.Office.Interop.Visio.Pages.

As seções a seguir 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 Page

Objeto de aplicativo

O objeto Microsoft.Office.Interop.Visio.Application 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 do Microsoft.Office.Interop.Visio.Application e os Microsoft.Office.Interop.Visio.ApplicationSettings objetos para controlar o ambiente do Visio.

Em projetos de suplemento VSTO, você pode acessar o objeto Microsoft.Office.Interop.Visio.Application usando o Application ThisAddIn campo da classe. Para obter mais informações, consulte Programando a validação.

Objeto de documento

O objeto Microsoft.Office.Interop.Visio.Document é central para a programação do Visio. Ele representa um arquivo de desenho, estêncil ou modelo. Ao abrir um documento do Visio ou criar um novo documento, você cria um novo objeto Microsoft.Office.Interop.Visio.Document, que é adicionado à coleção Microsoft.Office.Interop.Visio.Documents do objeto Microsoft.Office.Interop.Visio.Application.

O documento que tem o foco é chamado de documento ativo. Ele é representado pela Microsoft.Office.Interop.Visio.Application.ActiveDocument propriedade do objeto Microsoft.Office.Interop.Visio.Application.

Objeto Page

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

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

Usar 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 do modelo de objeto VBA do Visio. A referência do modelo de objeto VBA documenta o modelo de objeto do Visio como ele é exposto ao código do Visual Basic for Applications (VBA). Para obter mais informações, consulte Referência do modelo de objeto do Visio.

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

Observação

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

Para obter exemplos de código relacionados e ferramentas adicionais para criar soluções do Visio, consulte Kit de desenvolvimento de software do Visio 2010.

Tipos adicionais em assemblies de interoperabilidade primários

Você pode encontrar tipos nos assemblies de interoperabilidade primários que não são visíveis para o VBA devido a diferenças de implementação. O VBA fornece uma exibição do modelo de objeto do Visio que inclui apenas os objetos e membros que você pode usar diretamente. Os assemblies de interoperabilidade primários expõem o mesmo modelo de objeto, mas também incluem outras interfaces, classes e membros que convertem objetos no modelo de objeto COM em código gerenciado. Esses itens adicionais não se destinam a ser usados diretamente em seu código.

Para obter mais informações, consulte Visão geral de classes e interfaces nos assemblies de interoperabilidade primária do Office e assemblies de interoperabilidade primária do Office.