Información general sobre el modelo de objetos de Visio

Artículo
02/19/2013

Para desarrollar soluciones de Office para Microsoft Office Visio, puede interactuar con el modelo de objetos de Visio.Este modelo de objetos está compuesto de clases e interfaces que se proporcionan en el ensamblado de interoperabilidad primario para Visio y que se definen en el espacio de nombres Microsoft.Office.Interop.Visio.

En este tema se proporciona una breve información general sobre el modelo de objetos de Visio.Para obtener información sobre el uso del modelo de objetos de Visio para realizar tareas en proyectos de Office, vea los temas siguientes:

Descripción del modelo de objetos de Visio

Visio proporciona muchos objetos con los que se puede interactuar.Estos objetos se organizan en una jerarquía que sigue estrechamente la interfaz de usuario.En la parte superior de la jerarquía se encuentra el objeto Microsoft.Office.Interop.Visio.Application.Este objeto representa la instancia actual de Visio.El objeto Microsoft.Office.Interop.Visio.Application contiene los objetos Microsoft.Office.Interop.Visio.Document y Microsoft.Office.Interop.Visio.Page , así como las colecciones Microsoft.Office.Interop.Visio.Documents y Microsoft.Office.Interop.Visio.Pages.Cada uno de estos objetos y colecciones incluye numerosos métodos y propiedades a los que puede tener acceso para su manipulación y la interacción mutua.

Para obtener más información, vea la documentación de referencia de VBA para los objetos Microsoft.Office.Interop.Visio.Application, Microsoft.Office.Interop.Visio.Document y Microsoft.Office.Interop.Visio.Page y también para las colecciones Microsoft.Office.Interop.Visio.Documents y Microsoft.Office.Interop.Visio.Pages.

En la sección siguiente se explican brevemente los objetos de nivel superior y cómo interactúan entre sí.Estos objetos incluyen los siguientes:

Application
Document
Page (objeto)

Objeto Application

El objeto Microsoft.Office.Interop.Visio.Application representa la aplicación de Visio y es el primario de todos los demás objetos.Sus miembros normalmente son aplicables a Visio en su totalidad.Puede utilizar las propiedades y métodos de los objetos Microsoft.Office.Interop.Visio.ApplicationSettings y Microsoft.Office.Interop.Visio.Application para controlar el entorno de Visio.

En los proyectos de complemento en el nivel de la aplicación, puede obtener acceso al objeto Microsoft.Office.Interop.Visio.Application mediante el campo Application de la clase ThisAddIn.Para obtener más información, vea Programar complementos de nivel de aplicación.

Objeto Document

El objeto Microsoft.Office.Interop.Visio.Document es fundamental para la programación de Visio.Representa un archivo de dibujo, cliché o plantilla.Al abrir un documento de Visio o crear uno nuevo, se crea un nuevo objeto Microsoft.Office.Interop.Visio.Document que se agrega a la colección Microsoft.Office.Interop.Visio.Documents del objeto Microsoft.Office.Interop.Visio.Application.

El documento que tiene el foco se denomina documento activo.Se representa mediante la propiedad Microsoft.Office.Interop.Visio.Application.ActiveDocument del objeto Microsoft.Office.Interop.Visio.Application.

Objeto Page

El objeto Microsoft.Office.Interop.Visio.Page representa el área de dibujo de una página de primer plano o de fondo.Puede utilizar la propiedad Microsoft.Office.Interop.Visio.Page.Background para determinar si una página es de primer plano o de fondo.

Para crear formas, puede utilizar métodos como Microsoft.Office.Interop.Visio.Page.DrawSpline y Microsoft.Office.Interop.Visio.Page.DrawOval.Además, puede recuperar los patrones de los clichés y colocar formas en una página utilizando métodos Microsoft.Office.Interop.Visio.Page.DropMany o Microsoft.Office.Interop.Visio.Page.Drop.

Usar la documentación del modelo de objetos de Visio

Para obtener información completa sobre el modelo de objetos de Visio, puede consultar la referencia del modelo de objetos de VBA para Visio.La referencia del modelo de objetos de VBA documenta el modelo de objetos de Visio tal como se expone al código de Visual Basic para Aplicaciones (VBA).Para obtener más información, vea Referencia 2010 del modelo de objetos de Visio.

Todos los objetos y miembros de la referencia del modelo de objetos de VBA corresponden a tipos y miembros del ensamblado de interoperabilidad primario (PIA) de Visio.Por ejemplo, el objeto Document de la referencia del modelo de objetos de VBA corresponde al tipo Microsoft.Office.Interop.Visio.Document del PIA de Visio.Aunque la referencia del modelo de objetos de VBA proporciona ejemplos de código para la mayoría de las propiedades, métodos y eventos, debe convertir el código de VBA de esta referencia a Visual Basic o Visual C# si desea utilizarlos en un proyecto de complemento de Visio que cree mediante Visual Studio.

[!NOTA]

Por el momento, no hay ninguna documentación de referencia sobre el ensamblado de interoperabilidad primario de Visio.

Para obtener ejemplos de código relacionados y herramientas adicionales para crear soluciones de Visio, vea. Visio 2010 kit de desarrollo de software

Tipos adicionales en los ensamblados de interoperabilidad primarios

Hay tipos en los ensamblados de interoperabilidad primarios que no están visibles en VBA debido a las diferencias de implementación.VBA proporciona una vista del modelo de objetos de Visio que incluye sólo los objetos y miembros que se pueden utilizar directamente.Los ensamblados de interoperabilidad primarios exponen el mismo modelo de objetos, pero también incluyen otras interfaces, clases y miembros que traducen los objetos del modelo de objetos COM en código administrado.Estos elementos adicionales no deben usarse directamente en el código.

Para obtener más información, vea Información general de las clases e interfaces en los ensamblados de interoperabilidad primarios de Office y Ensamblados de interoperabilidad primarios de Office.