在 Microsoft Visio 中，注释是可以添加到形状、图表或图表中特定区域的注释或注释。这些注释提供有关图表内容的附加信息、解释或说明。注释是一种传达与 Visio 图表中存在的元素相关的上下文、详细信息或反馈的方式。 Visio 允许用户将注释附加到形状、连接器或图表的背景。在本文中，我们将学习如何使用 Python 向 Visio 图表添加注释。我们还将学习如何使用 Python 以编程方式编辑 VSD 或 VSDX 文件中的现有注释。
本文涵盖以下主题：
用于向 Visio 图表添加注释的 Python API
为了向 Visio 图表添加注释，我们将使用 Aspose.Diagram for Python。它使开发人员能够在 Python 应用程序中以编程方式使用 Microsoft Visio 文件。它允许创建新图表、修改现有图表、从图表中提取信息、将图表转换为不同的格式等等。 Aspose.Diagram for Python 简化了使用 Visio 文件时的开发过程，并提供了更高级别的 API，用于使用 Python 与这些文件进行交互。
请下载软件包或在控制台中使用以下 pip 命令从 PyPI 安装 API：
pip install aspose-diagram-python
在 Python 中向 Visio 图表添加注释
我们可以按照以下步骤轻松地向 Visio 图表添加注释：
- 使用Diagram 类加载Visio 图表。
- 从页面集合中按索引获取特定页面。
- 之后，使用 add_comment() 方法插入评论。
- 最后，使用 save() 方法保存 Visio 图表。它将输出 VSDX 文件路径和 SaveFileFormat 作为参数。
以下代码示例演示如何在 Python 中向 Visio 图表添加页面级注释。
# 此代码示例演示了如何在 Python 中向 Visio 图表添加页面级注释。
import aspose.diagram
from aspose.diagram import *
# 加载现有 Visio 图表
diagram = Diagram("C:\\Files\Drawing1.vsdx");
# 通过索引获取页面对象
page0 = diagram.pages[0];
# 为输入visio图添加注释
diagram.pages[0].add_comment(2.0, 3.0, "Comment");
# 保存 Visio 图表
diagram.save("C:\\Files\\AddComments.vsdx", SaveFileFormat.VSDX);
使用 Python 向 Visio 图表添加注释。
使用 Python 向 Visio 图表中的形状添加注释
同样，我们可以按照以下步骤为 Visio 图表的特定形状添加注释：
- 使用Diagram 类加载Visio 图表。
- 从页面集合中按索引获取特定页面。
- 通过 ID 从页面的形状集合中获取特定形状。
- 之后，使用 add_comment() 方法插入评论。传递形状对象和注释作为参数。
- 最后，使用 save() 方法保存 Visio 图表。它将输出 VSDX 文件路径和 SaveFileFormat 作为参数。
以下代码示例演示如何使用 Python 将注释添加到 Visio 图表中的形状。
# 此代码示例演示了如何在 Python 中向 Visio 图表添加页面级注释。
import aspose.diagram
from aspose.diagram import *
# 加载现有 Visio 图表
diagram = Diagram("C:\\Files\Drawing1.vsdx");
# 通过索引获取页面对象
page0 = diagram.pages[0];
# 通过 ID 检索形状
shape = page0.shapes.get_shape(1);
# 为形状添加注释
page0.add_comment(shape, "Comment");
# 保存 Visio 图表
diagram.save("C:\\Files\\addShapeComment.vsdx", SaveFileFormat.VSDX);
使用 Python 向 Visio 图表中的形状添加注释。
使用 Python 编辑 Visio 图表中的注释
我们还可以按照以下步骤编辑 Visio 图表中的任何注释：
- 使用Diagram 类加载Visio 图表。
- 从页面集合中按索引获取特定页面。
- 迭代注释的集合。
- 之后，读取 comment.value 属性并更新。
- 最后，使用 save() 方法保存 Visio 图表。它将输出 VSDX 文件路径和 SaveFileFormat 作为参数。
以下代码示例演示如何使用 Python 编辑 Visio 图表中的注释。
# 此代码示例演示了如何在 Python 中向 Visio 图表添加页面级注释。
import aspose.diagram
from aspose.diagram import *
# 加载现有 Visio 图表
diagram = Diagram("C:\\Files\Drawing1.vsdx");
# 通过索引获取页面对象
page0 = diagram.pages[0];
# 获取注释集合
annotations = page0.page_sheet.annotations;
# 遍历注释
for annotation in annotations:
comment = annotation.comment.value;
print(comment)
comment += " updation mark";
annotation.comment.value = comment;
print(annotation.comment.value)
# 保存 Visio 图表
diagram.save("C:\\Files\\EditPageLevelComment.vsdx", SaveFileFormat.VSDX);
使用 Python 编辑 Visio 图表中的注释。
获取免费的 API 许可证
获取免费临时许可证并免费体验该库的功能。利用免费的临时许可证，您可以探索该库的功能，而不会遇到任何限制。
向 Visio 图表添加注释 – 学习资源
探索该库的其他功能，并了解如何在不使用 Microsoft Visio 的情况下使用以下资源生成、转换和操作 Visio 图表：
结论
在这篇博文中，我们学习了如何使用 Python 向 Visio 图表添加注释。通过利用 Aspose.Diagram for Python，开发人员可以使用 Python 以编程方式自动化注释 Visio 图表的过程。如有任何疑问，请通过我们的免费支持论坛与我们联系。