Nuevo en Visio para desarrolladores

En este documento se proporciona una vista de nivel superior de las mejoras y las características agregadas para desarrolladores en Visio 2013. Para los desarrolladores que estén listos para iniciarse en la plataforma de Visio, este documento ofrece suficiente información para comenzar a codificar en Visio 2013.

Visio 2013 proporciona una eficaz plataforma única para soluciones gráficas personalizadas. Hay a su disposición más opciones para definir el comportamiento de los elementos de las soluciones, gracias a los nuevos objetos, colecciones, propiedades, métodos, enumeraciones y eventos, además de las nuevas celdas y funciones de ShapeSheet.

Entre las características de interés para los programadores en Visio 2013 están el nuevo formato de archivo; las actualizaciones sólidas de temas; la característica de cambio de formas (permite reemplazar unas formas con otra); nuevos efectos de formas; mejoras en los comentarios; la co-autoría en SharePoint Server 2013; el recorte de imágenes personalizable; la geometría relativa; la compatibilidad con datos de Servicios de conectividad empresarial (BCS); las actualizaciones de Servicios de Visio en Microsoft SharePoint Server 2013; y una característica página duplicada. En este tema se ofrece un breve resumen de cada una de estas características y se mencionan algunos de los nuevos objetos y miembros de Visio que están asociados con las características y se exponen en Visual Basic para Aplicaciones (VBA). Para obtener más información acerca de estas características y los ejemplos de código que las acompañan, consulte el Visio Developer Center.

Nota Nota

Visio 2013 incluye muchas celdas, filas y funciones nuevas de ShapeSheet para admitir las nuevas características de Visio. Para obtener más información sobre las novedades de ShapeSheet de Visio 2013, consulte el artículo Novedades para desarrolladores de Visio ShapeSheet.

Visio 2013 presenta un nuevo formato de archivo basado en el estándar de convenciones de empaquetado abierto (Open Packaging Conventions u OPC, ISO 29500 parte 2) y los elementos de XML del anterior formato de archivo XML de Visio (.vdx). Se trata de un formato de archivo comprimido y basado en XML similar a los formatos que se usan en otras aplicaciones de .

Dado que el nuevo formato de archivo es compatible con Visio 2013 y con Servicios de Visio en Microsoft SharePoint Server 2013, puede guardar un dibujo de Visio directamente en una biblioteca SharePoint Server sin tener que publicar el archivo como un dibujo web de Visio (.vdw). A pesar de ello, Servicios de Visio todavía puede leer y mostrar los archivos de dibujo web de Visio.

El nuevo formato de archivo incluye los siguientes tipos de archivo (por extensión):

  • .vsdx (dibujo de Visio)

  • .vsdm (dibujo habilitado para macros Visio)

  • .vssx (galería de símbolos de Visio)

  • .vssm (galería de símbolos habilitada para macros de Visio)

  • .vstx (plantilla de Visio)

  • .vstm (plantilla habilitada para macros de Visio)

Al hacer uso de la compatibilidad existente con la lectura y escritura del paquete de formatos de archivo (como, por ejemplo, System.IO.Packaging) y el análisis XML (System.Xml.Linq), puede trabajar mediante programación con los nuevos formatos de archivo.

Visio 2013 conserva la capacidad de leer los formatos de archivo anteriores (.vsd, .vss, .vst, .vdx, .vsx, .vtx, .vdw, .vwi). Visio 2013 no guarda en el formato de archivo XML anterior de Visio (.vdx). Es posible que las soluciones o herramientas que usaban archivos con el formato de archivo XML anterior de Visio (.vdx) deban refactorizarse para poder leer el nuevo formato de archivo y sus esquemas.

Servicios de Visio conserva la capacidad de mostrar el formato de dibujo web de Visio (.vdw) en el explorador. Ahora también representa los nuevos formatos de dibujo de Visio (.vsdx) y de dibujo habilitado para macros de Visio (.vsdm).

Los temas se han rediseñado en Visio 2013 con el fin de aprovechar mejor la gran variedad de efectos y estilos, incluyendo la integración de efectos de Shape Art. Ahora, los usuarios pueden decidirse por un estilo dominante aplicando un tema, personalizar el diagrama con variantes de tema y resaltar formas individuales con Estilos rápidos. Los desarrolladores de ShapeSheet pueden aprovechar estas características con las nuevas funciones y celdas en ShapeSheet.

También puede manipular temas en el nivel de los objetos Page, Shape y Selection. Las nuevas API para trabajar con temas incluyen los métodos Page.SetTheme, Page.SetThemeVariant, Shape.SetQuickStyle y Selection.SetQuickStyle.

Para obtener una lista detallada de las nuevas API en Visio 2013, consulte la sección Cambios del modelo de objetos de Visio en este artículo. Para obtener más información acerca de las nuevas celdas de ShapeSheet en Visio 2013, consulte el artículo Novedades para desarrolladores de Visio ShapeSheet.

Visio 2013 incluye una API de sustitución de formas que le permite cambiar una forma por otra incluida en una galería de símbolos, pero conservando algunos de los valores locales de la forma original, como la forma de texto de las formas, los datos de formas o el formato de formas. Los desarrolladores de formas pueden actualizar la configuración de ShapeSheet de sus formas personalizadas para especificar el comportamiento de Cambiar forma de sus formas. Entre las nuevas API están los métodos Shape.ReplaceShapes y Selection.ReplaceShapes y el evento ReplaceShape.

Para obtener una lista detallada de las nuevas API en Visio 2013, consulte la sección Cambios del modelo de objetos de Visio en este artículo. Para obtener más información acerca de las nuevas celdas de ShapeSheet en Visio 2013, consulte el artículo Novedades para desarrolladores de Visio ShapeSheet.

Se han agregado a Visio 2013 nuevos efectos de forma como los de bisel, giro 3D, iluminado, reflejo y esbozo. La ShapeSheet incluye nuevas celdas para trabajar con estos efectos.

Para obtener más información acerca de las nuevas celdas de ShapeSheet en Visio 2013, consulte el artículo Novedades para desarrolladores de Visio ShapeSheet.

Visio 2013 incluye un nuevo marco de comentarios. Ahora los comentarios se pueden asociar con una determinada forma o página. Visio 2013 incluye dos nuevos objetos, Comments y Comment. Las nuevas API para obtener acceso a los comentarios mediante programación incluyen las propiedades Document.Comments, Page.Comments, Shape.Comments y Page.ShapeComments.

Servicios de Visio incluye las API de JavaScript para leer los comentarios de una página o forma en un diagrama.

Para obtener una lista detallada de las nuevas API en Visio 2013, consulte la sección Cambios del modelo de objetos de Visio en este artículo.

Nota Nota

Ya no se puede obtener acceso a los comentarios a través de la ShapeSheet.

Visio 2013 permite la co-autoría de diagramas almacenados en SharePoint o Microsoft OneDrive. Los desarrolladores tienen acceso al evento Document.AfterDocumentMerge que proporciona información sobre los cambios realizados al diagrama debidos a la co-autoría. Los desarrolladores de soluciones también pueden deshabilitar la co-autoría para adaptarse a sus necesidades personalizadas mediante la celda NoCoauth en la ShapeSheet del documento.

Para obtener una lista detallada de las nuevas API en Visio 2013, consulte la sección Cambios del modelo de objetos de Visio en este artículo.

Visio 2013 admite la definición de una ruta de recorte de imágenes personalizable para recortar las imágenes a cualquier forma. Esta opción amplía las capacidades de Visio 2010, que admitía el recorte de imágenes en forma rectangular. Esta funcionalidad está disponible en la ShapeSheet mediante la celda ClippingPath de la sección Foreign Image Info.

Para obtener más información acerca de las nuevas celdas de ShapeSheet en Visio 2013, consulte el artículo Novedades para desarrolladores de Visio ShapeSheet.

En versiones anteriores de Visio, la geometría de las formas se definía mediante fórmulas que dependían de la altura o la anchura de la forma. Por ejemplo, en Visio 2010 los vértices de muchas formas de Visio integradas se definieron multiplicando la altura por la anchura de la forma por una constante. Estas formas tenían secciones de Geometría que incluían las filas MoveTo o LineTo (por ejemplo) con fórmulas como Width*1 y Height*0.

Ahora, Visio 2013 admite geometría relativa en la ShapeSheet. Los desarrolladores de formas pueden usar geometrías relativas para especificar las geometrías como simples valores o fórmulas, que se multiplican por la altura o la anchura de forma automática. Los vértices de las formas se pueden expresar ahora con constantes, por ejemplo, lo que elimina la necesidad de expresar los vértices como múltiplos de la anchura o la altura de la forma. Esto facilita a los desarrolladores la tarea de crear formas, a la vez que mejora el rendimiento y reduce los tamaños de archivos. Las nuevas filas incluyen las filas RelMoveTo y RelLineTo donde los valores de las celdas X e Y se multiplican de forma automática por la anchura o la altura de la forma (respectivamente).

Para obtener más información acerca de las nuevas filas de ShapeSheet en Visio 2013, consulte el artículo Novedades para desarrolladores de Visio ShapeSheet.

Los diagramas de Visio 2013 ahora se pueden conectar a listas externas en servidores de SharePoint Server 2013. Una lista externa es un origen de contenido externo en SharePoint (por ejemplo, una tabla de SQL Server) que se ha conectado a una lista de SharePoint mediante Servicios de conectividad empresarial de Microsoft (BCS). Servicios de Visio admite la posibilidad de actualizar los diagramas de Visio en cuanto se actualizan los datos.

Para obtener más información sobre las novedades de Servicios de Visio, consulte el artículo Servicios de Visio en SharePoint 2013. Para obtener más información sobre Servicios de conectividad empresarial (BCS), consulte Servicios de conectividad empresarial en SharePoint 2013.

Servicios de Visio en Microsoft SharePoint Server 2013 incluye muchas mejoras. Tal como se mencionó anteriormente, Servicios de Visio admite el nuevo formato de archivo de Visio (ambos .vsdx y .vsdm). Servicios de Visio ha ampliado la actualización y el recálculo de los datos, incluida la capacidad de recalcular fórmulas en todo el diagrama.

Para obtener más información sobre las novedades de Servicios de Visio, consulte el artículo Servicios de Visio en SharePoint 2013.

Ahora puede copiar una página y todas sus formas dentro del mismo documento en Visio 2013. De acuerdo con esto, el objeto Page tiene un nuevo método, Duplicar, que duplica la página y devuelve un nuevo objeto Page.

Se han agregado nuevos objetos, propiedades, métodos y eventos al modelo de objetos de Visio para proporcionar compatibilidad mediante programación con nuevas características de Visio 2013. Adicionalmente, las mejoras del modelo de objetos resuelven las frecuentes solicitudes de los desarrolladores relacionadas con los cambios a la plataforma de Visio.

Nuevos miembros

Los siguientes miembros se han agregado a los objetos existentes en el modelo de objetos de Visio.

Tabla 1. Mejoras del modelo de objetos de Visio

Objeto o colección

Nuevos miembros

Objeto de la aplicación (Visio)

Evento Application.AfterReplaceShapes (Visio)

Evento Application.BeforeReplaceShapes (Visio)

Evento Application.QueryCancelReplaceShapes (Visio)

Evento Application.ReplaceShapesCanceled (Visio)

ApplicationSettings (objeto) (Visio)

ApplicationSettings.EnterCommitsText Property (Visio)

ApplicationSettings.SVGExportFormat Property (Visio)

Objeto Document (Visio)

Evento Document.AfterDocumentMerge (Visio)

Document.Comments Property (Visio)

Document.CompatibilityMode Property (Visio)

Documents (colección) (Visio)

Evento Documents.AfterDocumentMerge (Visio)

Evento Documents.AfterReplaceShapes (Visio)

Evento Documents.BeforeReplaceShapes (Visio)

Evento Documents.QueryCancelReplaceShapes (Visio)

Evento Documents.ReplaceShapesCanceled (Visio)

Objeto InvisibleApp (Visio)

Evento InvisibleApp.AfterReplaceShapes (Visio)

Evento InvisibleApp.BeforeReplaceShapes (Visio)

Evento InvisibleApp.QueryCancelReplaceShapes (Visio)

Evento InvisibleApp.ReplaceShapesCanceled (Visio)

Objeto Page (Visio)

Evento Page.AfterReplaceShapes (Visio)

Evento Page.BeforeReplaceShapes (Visio)

Page.Comments Property (Visio)

Page.Duplicate Method (Visio)

Método Page.GetTheme (Visio)

Método Page.GetThemeVariant (Visio)

Evento Page.QueryCancelReplaceShapes (Visio)

Evento Page.ReplaceShapesCanceled (Visio)

Método Page.SetTheme (Visio)

Método Page.SetThemeVariant (Visio)

Propiedad Page.ShapeComments (Visio)

Colección de Pages (Visio)

Evento Pages.AfterReplaceShapes (Visio)

Evento Pages.BeforeReplaceShapes (Visio)

Evento Pages.QueryCancelReplaceShapes (Visio)

Evento Pages.ReplaceShapesCanceled (Visio)

Objeto Selection (Visio)

Método Selection.ReplaceShape (Visio)

Método Selection.SetQuickStyle (Visio)

Objeto Shape (Visio)

Método Shape.ChangePicture (Visio)

Shape.Comments Property (Visio)

Método Shape.ReplaceShape (Visio)

Método Shape.SetQuickStyle (Visio)

Nuevos objetos y enumeraciones

Los siguientes objetos se han agregado al modelo de objetos de Visio.

Tabla 2. Adiciones al modelo de objetos de Visio

La siguiente tabla muestra las nuevas enumeraciones y constantes introducidas en Visio 2013.

Tabla 3. Adiciones de enumeraciones de Visio

Enumeración

Descripción

Enumeración de VisQuickStyleColors (Visio)

Especifica nombres designados para los colores contenidos dentro de un tema.

Enumeración de VisQuickStyleMatrixIndices (Visio)

Especifica los nombres designados para los temas y las variaciones que proporciona Visio 2013.

Enumeración de VisReplaceFlags (Visio)

Especifica los comportamientos de una operación de cambio de forma.

Enumeración de VisSVGExportFormat (Visio)

Especifica la inclusión o exclusión del marcado de Visio al exportar un diagrama a SVG.

Objetos y miembros desusados

La siguiente tabla enumera los objetos y miembros que están en desuso introducidos en Visio 2013. En la columna Miembros desusados, solo se incluyen los miembros del objeto en desuso.

Tabla 4. Degradaciones del modelo de objetos de Visio

Objeto o colección

Miembros desusados

Objeto Window

Propiedad PageTabWidth

Mostrar: