Shape 接口

定义

命名空间:

Microsoft.Office.Interop.Excel

程序集:

Microsoft.Office.Interop.Excel.dll

代表绘图层中的对象，例如自选图形、任意多边形、OLE 对象或图片。 Shape 对象是 集合的成员Shapes。 Shapes 集合包含幻灯片上的所有形状。

public interface class Shape

[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface Shape

Public Interface Shape

属性

GuidAttribute InterfaceTypeAttribute

注解

有三个对象表示形状： Shapes 集合，表示文档上的所有形状; ShapeRange 例如，代表文档上形状的指定子集的集合 (ShapeRange 对象可以表示文档上的第一个形状和第四个形状，也可以代表文档) 上所有选定的形状; Shape 对象表示文档上的单个形状。 如果您需要同时处理几个形状，或处理选定区域中的多个形状，请使用 ShapeRange 集合。

本部分介绍如何︰

• 返回现有的形状。
• 返回选定区域中的形状。
• 返回与连接符的端点相连的形状。
• 返回新建的任意多边形。
• 返回组合内的单个形状。
• 返回新组成的形状组。

返回现有的形状

使用 Shapes (index) （其中 index 是形状名称或索引号）返回代表形状的 Shape 对象。

每个添加到 Shapes 集合的形状将被分配一个默认名称。 若要为形状指定更有意义的名称，请使用 Name 属性。

返回选定区域中的形状

使用 Selection.ShapeRange (index) （其中 index 是形状名称或索引号）返回一个代表选定内容中形状的 Shape 对象。

返回与连接符的端点相连的形状

若要返回一个 Shape 对象，该对象代表连接线附加的形状之一，请使用 BeginConnectedShape 或 EndConnectedShape 属性。

返回新建的任意多边形

BuildFreeform(MsoEditingType, Single, Single)使用 和 AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) 方法定义新任意多边形的几何图形，并使用 ConvertToShape() 方法创建任意多边形并返回代表该任意多边形的 Shape 对象。

返回组中的单个形状

使用 GroupItems (index) （其中 index 是组中的形状名称或索引号）返回一个 Shape 对象，该对象代表分组形状中的单个形状。

返回新组成的形状组

Group()使用 或 Regroup() 方法对一系列形状进行分组，并返回表示新形成的组的单个 Shape 对象。 一组形成之后，处理组相同的方式使用任何其他形状。

属性

Adjustments	返回一个 Adjustments 对象，该对象包含指定形状中所有调整的调整值。 此为只读属性。
AlternativeText	返回或设置对象保存到网页时对象的替代 () 文本字符串 Shape 的描述性。 读/写 String。
Application	返回一个 Application 对象，该对象代表 Microsoft Excel 应用程序。 此为只读属性。
AutoShapeType	返回或设置指定 Shape 对象的形状类型，该对象必须表示自选图形，而不是线条、任意多边形绘图或连接线。 读/写 MsoAutoShapeType。
BackgroundStyle	返回或设置背景样式。 读/写。
BlackWhiteMode	返回或设置一个值，该值指示以黑白模式查看演示文稿时指定形状的出现形式。 读/写 MsoBlackWhiteMode。
BottomRightCell	返回一个 Range 对象，该对象表示位于对象右下角下的单元格。 此为只读属性。
Callout	返回一个 CalloutFormat 对象，该对象包含指定形状的标注格式属性。 Shape适用于表示行标注的对象。 此为只读属性。
CanvasItems	仅供内部使用。
Chart	返回一个 对象，该对象表示 _Chart 中包含的 Shape。 此为只读属性。
Child	如果指定的形状是子形状，或者如果形状区域中的所有形状都是同一个父形状的子形状，则返回 msoTrue。 只读 MsoTriState。
ConnectionSiteCount	返回指定形状中的连结点的数量。 只读 Integer。
Connector	如果指定的形状是连接符，则此属性为 True。 只读 MsoTriState。
ConnectorFormat	返回一个 ConnectorFormat 对象，该对象包含连接器格式设置属性。 适用于 Shape 表示连接器的对象。 此为只读属性。
ControlFormat	返回一个 ControlFormat 对象，该对象包含 Microsoft Excel 控件属性。 此为只读属性。
Creator	返回一个 32 位整数，该整数指示在其中创建了此对象的应用程序。 如果该对象是在 Microsoft Excel 中创建的，则此属性返回字符串 XCEL，它等同于十六进制的数字 5843454C。 只读 XlCreator。
Diagram	返回表示 Diagram 关系图的 对象。
DiagramNode	返回一个 DiagramNode 对象，该对象代表关系图中的节点。
DrawingObject	仅供内部使用。
Fill	返回一个 FillFormat 对象，该对象包含指定图表或形状的填充格式属性。 此为只读属性。
FormControlType	返回 Microsoft Excel 控件类型。 只读 XlFormControl。
Glow	返回指定形状的对象，该形状包含该形状的发光格式属性。 此为只读属性。
GroupItems	返回一个 GroupShapes 对象，该对象代表指定组中的各个形状。 Item(Object)使用 GroupShapes 对象的 方法可返回组中的单个形状。 适用于 Shape 表示分组形状的对象。 此为只读属性。
HasChart	返回有关 是否 Shape 包含图表的信息。 此为只读属性。
HasDiagram	返回形状或形状区域是否包含关系图。 只读 MsoTriState。
HasDiagramNode	返回一个值，该值指示图表节点是否存在于给定的形状或形状范围内。 只读 MsoTriState。
HasSmartArt	获取指定形状上是否存在 SmartArt 图表。
Height	对象的高度。 读/写 单个 。
HorizontalFlip	如果指定的形状绕水平对称轴翻转，则为 True。 只读 MsoTriState。
Hyperlink	返回一个 Hyperlink 对象，该对象代表形状的超链接。
ID	返回指定对象的类型。 只读 Integer。
Left	从 对象的左边缘到工作表上 A 列的左边缘 () 或图表) 上图表区左边缘 (的距离。 读/写 单个 。
Line	返回一个 LineFormat 对象，该对象包含指定形状的线条格式属性。 此为只读属性。
LinkFormat	返回一个 LinkFormat 对象，该对象包含链接的 OLE 对象属性。 此为只读属性。
LockAspectRatio	如果指定的形状在调整大小时其原始比例保持不变，则此属性为 True。 如果调整大小时可以分别更改形状的高度和宽度，则此属性为 False。 读/写 MsoTriState。
Locked	如果对象 已锁定，则为 False ;如果可以在工作表受到保护时修改对象，则为 False。 读/写 Boolean。
Name	返回或设置对象的名称。 读/写 String。
Nodes	返回一个 ShapeNodes 集合，该集合表示指定形状的几何说明。 适用于 Shape 表示任意多边形绘图的对象。
OLEFormat	返回包含 OLEFormat OLE 对象属性的对象。 此为只读属性。
OnAction	返回或设置单击指定对象时运行的宏的名称。 读/写 String。
Parent	返回指定对象的父对象。 只读。
ParentGroup	返回一个 Shape 对象，该对象代表子形状或子形状范围的常见父形状。
PictureFormat	返回一个 PictureFormat 对象，该对象包含指定形状的图片格式属性。 适用于 Shape 表示图片或 OLE 对象的对象。 此为只读属性。
Placement	返回或设置对象附加到其下方单元格的方式。 读/写 XlPlacement。
Reflection	返回一个 对象，该对象包含形状的反射格式属性。 此为只读属性。
Rotation	返回或设置形状的旋转度（以度为单位）。 读/写 单个 。
Script	返回 Script 对象，该对象代表指定网页上的一段脚本或代码。 如果该网页中不包含任何脚本，则不返回任何内容。
Shadow	如此 如果 对象有阴影。 读/写 Boolean。
ShapeStyle	返回或设置一个 MsoShapeStyleIndex ，该值代表形状的形状样式。 读/写。
SmartArt	获取一个 对象，该对象表示与形状关联的 SmartArt。
SoftEdge	返回 SoftEdgeFormat 指定形状的对象，该对象包含形状的软边缘格式属性。 此为只读属性。
TextEffect	返回一个 TextEffectFormat 对象，该对象包含指定形状的文本效果格式属性。 适用于表示艺术字的 T：Microsoft.Office.Interop.Excel.Shape 对象。 此为只读属性。
TextFrame	返回一个 TextFrame 对象，该对象包含指定形状的对齐和定位属性。 此为只读属性。
TextFrame2	返回一个 对象，该对象包含指定形状的文本格式设置。 此为只读属性。
ThreeD	返回一个 ThreeDFormat 对象，该对象包含指定形状的三维效果格式属性。 此为只读属性。
Title	获取或设置与指定形状关联的可选文本的标题。
Top	形状区域中最顶部形状的上边缘到工作表上边缘的距离。 读/写 单个 。
TopLeftCell	返回一个 Range 对象，该对象表示位于指定对象的左上角下的单元格。 此为只读属性。
Type	返回或设置形状类型。 只读 MsoShapeType。
VerticalFlip	如果指定形状围绕垂直轴进行翻转，则该属性值为 True。 只读 MsoTriState。
Vertices	将指定任意多边形形状的顶点（及贝塞尔曲线的控制点）坐标作为一系列坐标对返回。 只读 对象 。
Visible	决定对象是否可见。 读/写 MsoTriState。
Width	对象的宽度。 读/写 单个 。
ZOrderPosition	返回指定的形状在 z 顺序中的位置。 只读 Integer。

方法

Apply()	适用于使用 PickUp() 方法复制的指定形状格式。
CanvasCropBottom(Single)	仅供内部使用。
CanvasCropLeft(Single)	仅供内部使用。
CanvasCropRight(Single)	仅供内部使用。
CanvasCropTop(Single)	仅供内部使用。
Copy()	将对象复制到剪贴板。
CopyPicture(Object, Object)	将所选对象作为图片复制到剪贴板。
Cut()	将对象剪切到剪贴板，或者将其粘贴到指定的目的地。
Delete()	删除对象。
Duplicate()	复制对象，并返回对新复制对象的引用。
Flip(MsoFlipCmd)	绕指定形状的水平或垂直对称轴翻转该形状。
IncrementLeft(Single)	将指定形状水平移动指定的磅数。
IncrementRotation(Single)	使指定的形状绕 Z 轴旋转指定的角度。 Rotation使用 属性设置形状的绝对旋转。
IncrementTop(Single)	以指定磅数垂直移动指定形状。
PickUp()	复制指定形状的格式。 Apply()使用 方法可将复制的格式应用于另一个形状。
RerouteConnections()	重置连接符，使它们可以采用最短的路径连接的形状。
ScaleHeight(Single, MsoTriState, Object)	按指定因子缩放形状的高度。
ScaleWidth(Single, MsoTriState, Object)	按指定因子缩放形状的宽度。
Select(Object)	选择对象。
SetShapesDefaultProperties()	将指定形状的格式设置为形状的默认格式。
Ungroup()	取消指定的形状或形状范围中所有组合的形状的组合。 在指定形状中反汇编图片和 OLE 对象。 将未组合的形状作为单个 ShapeRange 对象返回。
ZOrder(MsoZOrderCmd)	将指定形状移动到集合中的其他形状的前面或后面（即更改 z 顺序中的形状位置）。