Novo no Visio para desenvolvedores

Este documento oferece uma exibição de nível superior dos aprimoramentos e das adições para desenvolvedores no Visio 2013. Para os desenvolvedores que já estiverem prontos para começarem a usar a plataforma Visio, ele oferece detalhes suficientes para iniciar a codificação no Visio 2013.

O Visio 2013 oferece uma única plataforma poderosa para suas soluções de desenho personalizadas. Novos objetos, coleções, propriedades, métodos, enumerações e eventos, junto com novas células e funções ShapeSheet, oferecem a você mais opções para a definição do comportamento dos elementos em suas soluções.

Entre os novos recursos interessantes para desenvolvedores no Visio 2013, estão o novo formato de arquivo, atualizações robustas para temas, o recurso de alteração de forma (permitindo que você substitua formas por outras), novos efeitos de forma, aprimoramentos para comentários, coautoria no SharePoint Server 2013, recorte de imagem personalizada, geometria relativa, suporte para dados do Business Connectivity Services (BCS), atualizações para o Visio Services in Microsoft SharePoint Server 2013 e um recurso de duplicação de página. Este tópico oferece um breve resumo de cada um desses recursos e menciona alguns dos novos objetos e membros do Visio associados aos recursos e expostos no Visual Basic for Applications (VBA). Para saber mais sobre esses recursos e os exemplos de código associados, consulte o Centro de Desenvolvimento do Visio.

Observação Observação

O Visio 2013 inclui várias células, linhas e funções ShapeSheet novas para dar suporte aos novos recursos no Visio. Para saber mais sobre o que há de novo no ShapeSheet para o Visio 2013, consulte o artigo O que há de novo para desenvolvedores do ShapeSheet do Visio.

O Visio 2013 introduz um novo formato de arquivo, baseado no padrão OPC (Open Packaging Conventions) (ISO 29500, Parte 2) e os elementos XML do formato de arquivo XML anterior do Visio (.vdx). É um formato de arquivo compactado baseado em XML semelhante aos formatos de arquivo usados em outros aplicativos do .

Como o novo formato de arquivo tem suporte do Visio 2013 e do Visio Services in Microsoft SharePoint Server 2013, você pode salvar um desenho do Visio diretamente para uma biblioteca do SharePoint Server, sem precisar publicar o arquivo como um Desenho da Web do Visio (.vdw). Mesmo assim, o Visio Services ainda pode ler e exibir arquivos de Desenho da Web do Visio.

O novo formato de arquivo inclui os tipos de arquivo a seguir (por extensão):

  • .vsdx (desenhos do Visio)

  • .vsdm (desenhos do Visio ativados por macro)

  • .vssx (estêncil do Visio)

  • .vssm (estêncil do Visio ativados por macro)

  • .vstx (modelo do Visio)

  • .vstm (modelos do Visio ativados por macro)

Usando o suporte existente para ler e escrever o pacote de formato de arquivo (como System.IO.Packaging) e para análise de XML (System.Xml.Linq), você pode trabalhar programaticamente com os novos formatos de arquivo.

O Visio 2013 mantém a capacidade de ler os formatos de arquivo antigos (.vsd, .vss, .vst, .vdx, .vsx, .vtx, .vdw, .vwi). O Visio 2013 não salva no formato de arquivo XML anterior do Visio (.vdx). As soluções ou as ferramentas que consumirem os arquivos do formato de arquivo XML anterior do Visio (.vdx) talvez precisem ser refatorados para que leiam o novo formato de arquivo e seus esquemas.

O Visio Services mantém a capacidade de exibir o formato Desenho da Web do Visio (.vdw) no navegador. Ele também renderiza o novo desenho do Visio (.vsdx) e os formatos de desenho habilitado para macro do Visio (.vsdm).

Os temas foram reprojetados no Visio 2013, fazendo uso de uma variedade maior de efeitos e de estilos incluindo a integração de efeitos de Arte de Forma. Agora, os usuários decidem sobre um estilo abrangente ao aplicar um tema, personalizam o diagrama com variantes de tema e realçam formas individuais com os Estilos Rápidos. Os desenvolvedores de ShapeSheet podem aproveitar as vantagens desses recursos com as novas funções e células no ShapeSheet.

Você também pode manipular temas no nível do objeto Page, Shape e Selection. As novas APIs para o trabalho com temas incluem o método Page.SetTheme, o método Page.SetThemeVariant, o método Shape.SetQuickStyle e o método Selection.SetQuickStyle.

Para obter uma lista detalhada das novas APIs no Visio 2013, consulte a seção Alterações no modelo de objeto do Visio deste artigo. Para saber mais sobre as novas células ShapeSheet do Visio 2013, consulte o artigo O que há de novo para desenvolvedores do ShapeSheet do Visio.

O Visio 2013 inclui uma API de substituição de forma que permite a você trocar uma ou mais formas por outra forma contida em um estêncil, mantendo alguns dos valores locais da forma original, como o texto da forma, os dados da forma ou a formatação da forma. Os desenvolvedores de forma podem atualizar as configurações do ShapeSheet das formas personalizadas para especificar o comportamento de Alterar Forma para as formas. Entre as novas APIs, estão os métodos Shape.ReplaceShapes e Selection.ReplaceShapes e o evento ReplaceShape.

Para obter uma lista detalhada das novas APIs no Visio 2013, consulte a seção Alterações no modelo de objeto do Visio neste artigo. Para saber mais sobre as novas células ShapeSheet do Visio 2013, consulte o artigo O que há de novo para desenvolvedores do ShapeSheet do Visio.

Novos efeitos de forma, como bisel, rotação 3D, brilho, reflexão e delineamento foram adicionados ao Visio 2013. O ShapeSheet inclui novas células para trabalhar com esses efeitos.

Para saber mais sobre as novas células ShapeSheet do Visio 2013, consulte o artigo O que há de novo para desenvolvedores do ShapeSheet do Visio.

O Visio 2013 inclui uma nova estrutura de comentários. Agora, os comentários podem ser associados a uma forma ou página em particular. O Visio 2013 inclui dois novos objetos, Comments e Comment. As novas APIs para acessar comentários programaticamente incluem as propriedades Document.Comments, Page.Comments, Shape.Comments e Page.ShapeComments.

O Visio Services inclui APIs JavaScript para ler os comentários de uma página ou de uma forma em um diagrama.

Para obter uma lista detalhada de novas APIs no Visio 2013, consulte a seção Alterações no modelo de objeto do Visio deste artigo.

Observação Observação

Os comentários não podem mais ser acessados por meio do ShapeSheet.

O Visio 2013 inclui a capacidade de coautoria de diagramas armazenados no SharePoint ou no Microsoft OneDrive. Os desenvolvedores têm acesso ao evento Document.AfterDocumentMerge, que oferece informações sobre alterações de diagrama devido à coautoria. Os desenvolvedores de solução também têm a capacidade de desabilitar a coautoria para o ajuste às necessidades personalizadas usando a célula NoCoauth no ShapeSheet do Documento.

Para obter uma lista detalhada de novas APIs no Visio 2013, consulte a seção Alterações no modelo de objeto do Visio deste artigo.

O Visio 2013 dá suporte à definição a um caminho de Recorte de Imagem Personalizado para cortar imagens em qualquer forma. Isso estende os recursos do Visio 2010, que dão suporte a imagens de recorte de uma maneira retangular. Essa funcionalidade está disponível no ShapeSheet usando a célula ClippingPath na seção Foreign Image Info.

Para saber mais sobre as novas células ShapeSheet do Visio 2013, consulte o artigo O que há de novo para desenvolvedores do ShapeSheet do Visio.

Nas versões anteriores do Visio, a geometria da forma foi definida por fórmulas que dependiam da altura ou da largura da forma. Por exemplo, no Visio 2010, os vértices de várias formas internas do Visio eram definidas pela multiplicação da altura ou da largura da forma por uma constante. Essas formas tinham seções Geometry que incluíam linhas MoveTo ou LineTo (por exemplo) com fórmulas como Width*1 e Height*0.

Agora, o Visio 2013 dá suporte a geometria relativa no ShapeSheet. Os desenvolvedores de forma pode usar geometrias relativas para especificar geometrias como valores ou fórmulas simples, que multiplicam pela altura ou pela largura automaticamente. Os vértices de forma podem ser expressos como constantes, por exemplo, removendo a necessidade de expressar vértices como múltiplos da largura ou da altura da forma. Isso facilita para que os desenvolvedores criem formas, com um desempenho melhor e tamanhos de arquivo menores. As novas linhas incluem as linhas RelMoveTo e RelLineTo onde os valores de célula X e Y são automaticamente multiplicados pela largura ou altura da forma (respectivamente).

Para saber mais sobre as novas linhas ShapeSheet no Visio 2013, consulte o artigo O que há de novo para desenvolvedores do ShapeSheet do Visio.

Agora, os diagramas do Visio 2013 podem ser conectados a listas externas em servidores do SharePoint Server 2013. Uma lista externa é uma fonte de conteúdo externa para o SharePoint (por exemplo, uma tabela do SQL Server) que foi conectada a uma lista do SharePoint usando o Microsoft Business Connectivity Services (BCS). O Visio Services dá suporte à capacidade de atualizar os diagramas do Visio quando os dados são atualizados.

Para saber mais sobre o que há de novo no Visio Services, consulte o artigo Serviços do Visio no SharePoint 2013. Para saber mais sobre o Business Connectivity Services (BCS), consulte Serviços de Conectividade Corporativos no SharePoint 2013.

O Visio Services in Microsoft SharePoint Server 2013 inclui vários aprimoramentos. Como mencionado anteriormente, o Visio Services dá suporte ao novo formato de arquivo do Visio (.vsdx e .vsdm). O Visio Services expandiu a atualização e o recálculo de dados, incluindo a capacidade de recalcular fórmulas em todo o diagrama.

Para saber mais sobre o que há de novo no Visio Services, consulte o artigo Serviços do Visio no SharePoint 2013.

Agora você pode copiar uma página e todas as suas formas no mesmo documento do Visio 2013. Da mesma forma, o objeto Page tem um novo método, Duplicate, que duplica a página e retorna um novo objeto Page.

Novos objetos, propriedades, métodos e eventos foram adicionados ao modelo de objeto do Visio para fornecerem suporte de programação para os novos recursos do Visio 2013. Adicionalmente, os aprimoramentos do modelo de objeto estão relacionados às solicitações frequentes dos desenvolvedores de alteração na plataforma Visio.

Novos membros

Os membros a seguir foram adicionados a objetos existentes no modelo de objeto do Visio.

Tabela 1. Aprimoramentos do modelo de objeto do Visio

Objeto ou coleção

Novos membros

Objeto de aplicativo (Visio)

Evento Application.AfterReplaceShapes (Visio)

Evento Application.BeforeReplaceShapes (Visio)

Evento Application.QueryCancelReplaceShapes (Visio)

Evento Application.ReplaceShapesCanceled (Visio)

Objeto ApplicationSettings (Visio)

Propriedade ApplicationSettings.EnterCommitsText (Visio)

Propriedade ApplicationSettings.SVGExportFormat (Visio)

Objeto de documento (Visio)

Evento Document.AfterDocumentMerge (Visio)

Propriedade Document.Comments (Visio)

Propriedade Document.CompatibilityMode (Visio)

Objeto de documentos (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 da página (Visio)

Evento Page.AfterReplaceShapes (Visio)

Evento Page.BeforeReplaceShapes (Visio)

Propriedade Page.Comments (Visio)

Método Page.Duplicate (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)

Page.ShapeComments Property (Visio)

Objeto 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)

Propriedade Shape.Comments (Visio)

Método Shape.ReplaceShape (Visio)

Método Shape.SetQuickStyle (Visio)

Novos objetos e enumerações

Os objetos a seguir foram adicionados ao modelo de objeto do Visio.

Tabela 2. Adições de modelo de objeto do Visio

A tabela a seguir lista as novas enumerações e constantes introduzidas no Visio 2013.

Tabela 3. Adições de enumeração do Visio

Enumeração

Descrição

Enumeração VisQuickStyleColors (Visio)

Especifica nomes designados para cores contidas em um tema.

Enumeração VisQuickStyleMatrixIndices (Visio)

Especifica nomes designados para os temas e as variações fornecidos com o Visio 2013.

Enumeração VisReplaceFlags (Visio)

Especifica comportamentos para uma operação Alterar Forma.

Enumeração VisSVGExportFormat (Visio)

Especifica a inclusão e a exclusão de marcação do Visio durante a exportação de um diagrama para o SVG.

Objetos e membros substituídos

A tabela a seguir lista os objetos e membros substituídos introduzidos no Visio 2013. Somente os membros de objeto substituídos são listados na coluna Membros preteridos.

Tabela 4. Substituições do modelo de objeto do Visio

Objeto ou coleção

Membros substituídos

Objeto Window

Propriedade PageTabWidth

Mostrar: