Adicione comentários ao diagrama do Visio em Python

No Microsoft Visio, comentários são anotações ou notas que podem ser adicionadas a formas, diagramas ou áreas específicas de um diagrama. Esses comentários fornecem informações, explicações ou instruções adicionais sobre o conteúdo do diagrama. Os comentários são uma forma de comunicar contexto, detalhes ou comentários relacionados aos elementos presentes no diagrama do Visio. O Visio permite que os usuários anexem comentários a formas, conectores ou ao plano de fundo do diagrama. Neste artigo, aprenderemos como adicionar comentários aos diagramas do Visio em Python. Também aprenderemos como editar comentários existentes em arquivos VSD ou VSDX programaticamente usando Python.

Este artigo cobre os seguintes tópicos:

API Python para adicionar comentários ao diagrama do Visio

Para adicionar comentários ao diagrama do Visio, usaremos Aspose.Diagram for Python. Ele permite que os desenvolvedores trabalhem com arquivos do Microsoft Visio programaticamente em aplicativos Python. Permite a criação de novos diagramas, modificando os existentes, extraindo informações de diagramas, convertendo diagramas para diferentes formatos e muito mais. Aspose.Diagram for Python simplifica o processo de desenvolvimento ao trabalhar com arquivos Visio e fornece uma API de nível superior para interagir com esses arquivos usando Python.

Por favor baixe o pacote ou instale a API de PyPI usando o seguinte comando pip no console:

pip install aspose-diagram-python

Adicionar comentários ao diagrama do Visio em Python

Podemos adicionar comentários facilmente a um diagrama do Visio seguindo as etapas abaixo:

  1. Carregue o diagrama do Visio usando a classe Diagram.
  2. Obtenha uma página específica por índice da coleção de páginas.
  3. Depois disso, insira um comentário usando o método add_comment().
  4. Por fim, salve o diagrama do Visio usando o método save(). Ele usa o caminho do arquivo VSDX de saída e SaveFileFormat como argumentos.

O exemplo de código a seguir mostra como adicionar um comentário no nível da página a um diagrama do Visio em Python.

# Este exemplo de código demonstra como adicionar comentários no nível da página a um diagrama do Visio em Python.
import aspose.diagram
from aspose.diagram import *

# Carregar um diagrama do Visio existente
diagram = Diagram("C:\\Files\Drawing1.vsdx");

# Obtenha o objeto da página por índice
page0 = diagram.pages[0];

# Adicionar comentário ao diagrama do Visio de entrada
diagram.pages[0].add_comment(2.0, 3.0, "Comment");

# Salvar diagrama do Visio
diagram.save("C:\\Files\\AddComments.vsdx", SaveFileFormat.VSDX);
Adicionar comentários ao diagrama do Visio em Python

Adicione comentários ao diagrama do Visio em Python.

Adicionar comentários à forma no diagrama do Visio usando Python

Da mesma forma, podemos adicionar comentários a uma forma específica do diagrama do Visio seguindo as etapas abaixo:

  1. Carregue o diagrama do Visio usando a classe Diagram.
  2. Obtenha uma página específica por índice da coleção de páginas.
  3. Obtenha uma forma específica por ID da coleção de formas da página.
  4. Depois disso, insira um comentário usando o método add_comment(). Passe o objeto shape e um comentário como argumentos.
  5. Por fim, salve o diagrama do Visio usando o método save(). Ele usa o caminho do arquivo VSDX de saída e SaveFileFormat como argumentos.

O exemplo de código a seguir mostra como adicionar um comentário a uma forma no diagrama do Visio usando Python.

# Este exemplo de código demonstra como adicionar comentários no nível da página a um diagrama do Visio em Python.
import aspose.diagram
from aspose.diagram import *

# Carregar um diagrama do Visio existente
diagram = Diagram("C:\\Files\Drawing1.vsdx");

# Obtenha o objeto da página por índice
page0 = diagram.pages[0];

# Recuperar forma por ID
shape = page0.shapes.get_shape(1);

# Adicionar comentário à forma
page0.add_comment(shape, "Comment");

# Salvar diagrama do Visio
diagram.save("C:\\Files\\addShapeComment.vsdx", SaveFileFormat.VSDX);
Adicionar comentários à forma no diagrama do Visio usando Python

Adicione comentários a uma forma no diagrama do Visio usando Python.

Editar comentários no diagrama do Visio usando Python

Também podemos editar qualquer comentário em um diagrama do Visio seguindo as etapas abaixo:

  1. Carregue o diagrama do Visio usando a classe Diagram.
  2. Obtenha uma página específica por índice da coleção de páginas.
  3. Iterar através da coleção das anotações.
  4. Depois disso, leia a propriedade comment.value e atualize.
  5. Por fim, salve o diagrama do Visio usando o método save(). Ele usa o caminho do arquivo VSDX de saída e SaveFileFormat como argumentos.

O exemplo de código a seguir mostra como editar um comentário em um diagrama do Visio usando Python.

# Este exemplo de código demonstra como adicionar comentários no nível da página a um diagrama do Visio em Python.
import aspose.diagram
from aspose.diagram import *

# Carregar um diagrama do Visio existente
diagram = Diagram("C:\\Files\Drawing1.vsdx");

# Obtenha o objeto da página por índice
page0 = diagram.pages[0];

# Obtenha a coleção das anotações
annotations = page0.page_sheet.annotations;

# Iterar pelas anotações
for annotation in annotations:
    comment = annotation.comment.value;
    print(comment)
    comment += " updation mark";
    annotation.comment.value = comment;
    print(annotation.comment.value)

# Salvar diagrama do Visio
diagram.save("C:\\Files\\EditPageLevelComment.vsdx", SaveFileFormat.VSDX);
Editar comentários no diagrama do Visio usando Python

Edite comentários no diagrama do Visio usando Python.

Obtenha uma licença API gratuita

Obtenha uma licença temporária gratuita e experimente os recursos da biblioteca sem nenhum custo. A utilização de uma licença temporária gratuita permite explorar os recursos da biblioteca sem encontrar quaisquer restrições.

Adicionar comentários ao diagrama do Visio – Recursos de aprendizagem

Explore outros recursos da biblioteca e aprenda como gerar, converter e manipular diagramas do Visio sem usar o Microsoft Visio usando os seguintes recursos:

Conclusão

Nesta postagem do blog, aprendemos como adicionar comentários aos diagramas do Visio em Python. Ao aproveitar o Aspose.Diagram para Python, os desenvolvedores podem automatizar o processo de anotação do diagrama do Visio programaticamente usando Python. Em caso de qualquer ambigüidade, entre em contato conosco em nosso fórum de suporte gratuito.

Veja também