Información general sobre el modelo de objetos de Visio

Actualización: noviembre 2007

Para desarrollar soluciones de Visual Studio Tools para 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 cómo utilizar el modelo de objetos de Visio para realizar tareas en proyectos de Visual Studio Tools para 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.Page y Microsoft.Office.Interop.Visio.Document, y también para las colecciones Microsoft.Office.Interop.Visio.Pages y Microsoft.Office.Interop.Visio.Documents.

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 sobre las clases que se pueden utilizar en el modelo de objetos de Visio, consulte los siguientes conjuntos de documentación. En la documentación en línea de MSDN Library se proporciona información sobre el modelo de objetos de Visio, así como ejemplos de código en VBA. El Kit de desarrollo de software de Visio 2007 (SDK) proporciona ejemplos de código en Visual Basic y C#. El SDK de Visio 2007 también proporciona herramientas de publicación y plantillas de Visual Studio.

Microsoft Office Visio 2007

Microsoft Office Visio 2003

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 Overview of Classes and Interfaces in the Office Primary Interop Assemblies y Ensamblados de interoperabilidad primarios de Office.

Nota:

Por el momento, no hay ninguna documentación de referencia sobre los ensamblados de interoperabilidad primarios de Visio.

Referencia de VBA

Todos los objetos y miembros en la referencia de VBA corresponden a las clases y miembros del ensamblado de interoperabilidad primario que utiliza en proyectos de Visual Studio Tools para Office. Por ejemplo, el objeto Visio.Application de la documentación de VBA para Visio corresponde a la clase Microsoft.Office.Interop.Visio.Application en el ensamblado de interoperabilidad primario.

La referencia de VBA presenta las ventajas siguientes:

  • Documenta los modelos de objetos de Visio 2007 y Visio 2003.

  • Proporciona ejemplos de código para la mayoría de los miembros.

La referencia de VBA presenta las desventajas siguientes:

  • Sólo proporciona sintaxis y ejemplos de código para VBA. Para usar los ejemplos de código en un proyecto de Visual Studio Tools para Office, debe traducir el código de VBA a Visual Basic o Visual C#.

Vea también

Conceptos

Soluciones de Visio

Trabajar con documentos de Visio

Trabajar con formas de Visio