Help > 开发指南 > Excel > API > 主要对象 >

图表和图形

本文档提供有关嵌入的图形对象（形状、图片和图表）的信息。

此处涵盖的操作：

• 创建绘图对象
• 移动和定位图形对象
• 旋转图形对象并调整其大小
• 将图形对象与超链接关联
• 删除图形对象

创建绘图对象

Shape 接口是所有绘图对象的基本接口。这些对象存储在 ShapeCollection 集合中，可使用 Worksheet.Shapes 属性进行访问。

注意

图片和图表分别包含在两个集合中：ShapeCollection和PictureCollection或ChartCollection。

使用 Shape.ShapeType 属性可确定 ShapeCollection 中绘图对象的类型。

下表列出了支持的图形对象类型以及用于创建它们的方法。

Drawing 对象	说明	方法
Shape	形状	ShapeCollection.AddShape
Shape Group	形状组	ShapeCollection.GroupShapes
Text Box	文本框	ShapeCollection.AddTextBox
Shape Connector	形状连接器	ShapeCollection.AddConnector
Picture	图片	PictureCollection.AddPicture
Chart	图表	ChartCollection.Add

移动和定位图形对象

使用下表中的 API 定义图形对象的位置。

属性	描述
FloatingObject.Move	按指定的偏移量移动浮动对象。
FloatingObject.Left	获取或设置从工作表的左边缘到绘图对象的左上角的距离。
FloatingObject.OffsetX	指定浮动对象的左上角与浮动对象的左上角所在的单元格左边缘之间的距离。
FloatingObject.Top	定义工作表的上边缘与浮动对象的左上角之间的距离。
FloatingObject.OffsetY	获取浮动对象的左上角与浮动对象的左上角所在的单元格的上边缘之间的距离。
FloatingObject.TopLeftCell	指定浮动对象的左上角所在的单元格。
FloatingObject.BottomRightCell	获取或设置一个单元格，其中浮动对象的右下角所在的位置。
Shape.ZOrderPosition	检索当前绘图对象在 Z 顺序中的位置。默认形状的 Z 顺序值等于它们在.ShapeCollection （形状集合）
ShapeCollection.NormalizeZOrder	重置形状的 Z 顺序。

下图说明了此 API 指定的距离。

调整图形对象的大小和旋转

您可以使用以下属性指定绘图对象的大小和旋转角度。

• FloatingObject.Height - 定义对象的高度;
• FloatingObject.Width - 定义对象的宽度;
• FloatingObject.LockAspectRatio - 指定是否保持绘图对象的比例;
• Shape.Rotation - 获取或设置绘图对象的旋转角度;
• Shape.IncrementRotation - 将绘图对象旋转给定的度数。

最终用户可以使用特殊控点调整图形对象的大小或旋转这些控点，这些控点对选定对象可见。

FloatingObject.Placement 属性确定绘图对象是否与基础单元格一起移动和/或调整大小。例如，将 Placement 属性设置为 Placement.MoveAndSize，使绘图对象随单元格一起移动和调整大小，如下所示。

将图形对象与超链接关联

您可以提供指向图形对象的超链接。当最终用户单击绘图对象时，该链接将导航到 Internet 上的某个位置、文件、工作簿中的某个位置，或者发送电子邮件。使用 Shape.InsertHyperlink 方法指定绘图对象的超链接，并使用 Shape.RemoveHyperlink 方法删除超链接。有关代码示例，请参阅如何：向图片添加超链接主题。

删除图形对象

以下方法允许您删除图形对象。

• ChartCollection.RemoveAt，PictureCollection.RemoveAt，ShapeCollection.RemoveAt - 删除指定索引处的元素。
• Shape.Delete - 删除绘图对象。

另见
电子表格图表
电子表格形状
图片