在 Excel 中获取形状的连接点

介绍

当以编程方式处理 Excel 文件时，我们经常需要与工作表中嵌入的形状进行交互。您可以执行的更高级的任务之一是从形状中提取连接点。连接点用于将形状与连接器连接起来并更精确地管理其布局。如果您希望获取 Excel 中形状的连接点，Aspose.Cells for .NET 就是您需要的工具。在本教程中，我们将带您逐步完成实现此目的的过程。

先决条件

在深入研究代码之前，请确保您满足以下先决条件：

Aspose.Cells for .NET：您需要在开发环境中安装 Aspose.Cells。如果您还没有安装，您可以点击这里下载最新版本.
开发环境：确保您已安装可正常运行的 Visual Studio 或任何其他与 .NET 兼容的 IDE。
C# 基础知识：本教程假设您对 C# 编程和面向对象原理有基本的了解。您还可以注册Aspose.Cells 免费试用如果您还没有安装。这将使您能够访问本指南所需的所有功能。

导入包

为了在您的项目中使用 Aspose.Cells，您需要包含必要的命名空间。以下导入语句应放在代码顶部：

using System.IO;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using System.Drawing;

这些命名空间使您能够访问 Aspose.Cells 的核心功能，并允许您操作工作表和形状。

获取形状连接点的分步指南

在本节中，我们将引导您了解如何提取 Excel 工作表中形状的连接点。请仔细遵循每个步骤以获得清晰的理解。

步骤 1：实例化新工作簿

首先，我们需要创建一个Workbook类。这代表 Aspose.Cells 中的 Excel 文件。如果您没有现有文件，没问题 - 您可以从空白工作簿开始。

//实例化新的工作簿
Workbook workbook = new Workbook();

在此步骤中，我们创建了一个空的 Excel 工作簿，但您也可以通过将文件路径传递给Workbook构造函数。

第 2 步：访问第一个工作表

接下来，我们需要访问要使用形状的工作表。在本例中，我们将使用工作簿的第一个工作表。

//获取工作簿中第一个工作表
Worksheet worksheet = workbook.Worksheets[0];

此行从工作簿中的工作表集合中访问第一个工作表。如果您正在使用特定工作表，则可以替换索引0使用所需的索引。

步骤 3：添加新文本框（形状）

现在，让我们向工作表添加一个新形状。我们将创建一个文本框，它是一种形状。您还可以添加其他类型的形状，但为了简单起见，我们将在本教程中继续使用文本框。

//向集合中添加新的文本框
int textboxIndex = worksheet.TextBoxes.Add(2, 1, 160, 200);

以下是我们所做的工作：

在行中添加了文本框2，柱子1.
将文本框的尺寸设置为160宽度单位和200高度单位。

步骤 4：从 Shapes 集合访问 Shape

一旦添加了文本框，它就成为工作表形状集合的一部分。现在我们将使用Shapes收藏。

//从形状集合访问形状（文本框）
Shape shape = workbook.Worksheets[0].Shapes[0];

在此步骤中，我们从集合中检索第一个形状（我们的文本框）。如果您有多个形状，您可以指定索引，甚至按名称查找形状。

步骤 5：检索连接点

现在我们有了形状，让我们提取它的连接点。这些点用于将连接器连接到形状。ConnectionPoints形状的属性返回所有可用的连接点。

//获取此形状中的所有连接点
var connectionPoints = shape.ConnectionPoints;

这为我们提供了该形状可用的所有连接点的集合。

步骤 6：显示连接点

最后，我们要显示每个连接点的坐标。这就是我们循环遍历连接点并将它们打印到控制台的地方。

//显示所有形状点
foreach (var pt in connectionPoints)
{
    System.Console.WriteLine(string.Format("X = {0}, Y = {1}", pt.X, pt.Y));
}

此循环遍历每个连接点并打印X和Y坐标。这对于调试或直观地确认形状的连接点很有用。

步骤 7：执行并完成

设置完上述所有步骤后，即可运行代码。以下是确保该过程成功完成的最后一行：

System.Console.WriteLine("GetShapeConnectionPoints executed successfully.");

此行只是向控制台记录一条消息，表明该过程已完成。

结论

在本教程中，我们介绍了如何使用 Aspose.Cells for .NET 检索 Excel 中形状的连接点。通过将任务分解为小的、易于理解的步骤，我们探索了创建工作簿、添加形状和提取连接点的过程。通过了解如何以编程方式操作形状，您将开启构建动态和交互式 Excel 工作表的无限可能。无论您是构建报告、设计仪表板还是创建图表，这些知识都将派上用场。

常见问题解答

形状中的连接点是什么？

连接点是形状上的特定点，您可以在此连接或将其链接到其他形状。

我可以检索工作表中所有形状的连接点吗？

是的，Aspose.Cells 允许您检索任何支持连接点的形状的连接点。只需循环遍历工作表中的形状集合即可。

我需要许可证才能使用 Aspose.Cells 吗？

是的，虽然您可以免费试用，但需要许可证才能使用完整功能。您可以在这里购买许可证或者得到临时执照.

如何在 Aspose.Cells 中添加不同类型的形状？

您可以使用Add适用于矩形、椭圆形等形状的方法。每种形状都有您可以自定义的特定参数。

如何加载现有的 Excel 文件而不是创建新文件？

要加载现有文件，请将文件路径传递给Workbook构造函数，如下所示：

Workbook workbook = new Workbook("path_to_file.xlsx");

在 Excel 中将箭头添加到形状在 Excel 中向工作表添加按钮