Shape 接口

定义

命名空间:

Microsoft.Office.Interop.Word

程序集:

Microsoft.Office.Interop.Word.dll

表示对象在绘图层中，如自选图形、 任意多边形、 OLE 对象、 ActiveX 控件或图片。

public interface class Shape

[System.Runtime.InteropServices.Guid("000209A0-0000-0000-C000-000000000046")]
public interface Shape

type Shape = interface

Public Interface Shape

属性

GuidAttribute

注解

对象Shape是 集合的成员Shapes，该集合包括文档main文章中的所有形状或文档的所有页眉和页脚。

形状总是附加到某个锚定范围。 可以将形状放置在包含定位点的页面上的任意位置。

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

使用 Shapes (index) （其中 index 是名称或索引号）返回单个 Shape 对象。

每个形状创建时分配一个默认名称。 例如，如果向文档中添加了三个不同的形状，它们可能会被命名为"矩形 2、"文本框 3"和"椭圆 4。 若要为形状指定更有意义的名称，请 Name 设置 属性。

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

若要将 对象添加到Shape指定文档的形状集合并返回Shape表示新创建的形状的对象，请使用集合的下列方法Shapes之一：AddCallout(MsoCalloutType, Single, Single, Single, Single, Object)、、AddCurve(Object, Object)、AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object)AddLine(Single, Single, Single, Single, Object)、AddOLEControl(Object, Object, Object, Object, Object, Object)、AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)、 AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)AddShape(Int32, Single, Single, Single, Single, Object)AddPolyline(Object, Object)AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)或 。BuildFreeform(MsoEditingType, Single, Single)

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

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

每个 Shape 对象都定位到一个文本范围。 将某个形状锁定到包含锁定范围的第一段的开头。 该形状总是与其锁定标记在同一页上。

可以通过将 属性设置为 ShowObjectAnchorsTrue 来查看定位点本身。 形状的 Top 和 Left 属性决定了其垂直和水平位置。 形状的 RelativeHorizontalPosition 和 RelativeVerticalPosition 属性确定是从定位段落、包含定位段落的列、边距还是页面边缘测量位置。

LockAnchor如果形状的 属性设置为 True，则不能从定位点在页面上的位置拖动该定位点。

Fill使用 属性返回 FillFormat 对象，该对象包含用于设置封闭形状填充格式的所有属性和方法。 属性 Shadow 返回 ShadowFormat 对象，用于设置阴影的格式。 Line使用 属性返回 LineFormat 对象，该对象包含用于设置线条和箭头格式的属性和方法。 属性 TextEffect 返回 TextEffectFormat 对象，该对象用于设置艺术字的格式。 属性 Callout 返回 CalloutFormat 对象，该对象用于设置行标注的格式。 属性 WrapFormat 返回 WrapFormat 对象，该对象用于定义文本环绕形状的方式。 属性 ThreeD 返回 ThreeDFormat 用于创建三维形状的 对象。 可以使用 PickUp() 和 Apply() 方法将格式从一个形状转移到另一个形状。

SetShapesDefaultProperties()使用 对象的 方法Shape可设置文档的默认形状的格式。 新形状将继承默认形状的许多属性。

Type使用 属性可以指定形状的类型：自由多边形、自选图形、OLE 对象、标注或链接图片等。 AutoShapeType使用 属性可以指定自选图形的类型：例如，椭圆形、矩形或气球。

Width使用 和 Height 属性指定形状的大小。

属性 TextFrame 返回 TextFrame 对象，该对象包含用于将文本附加到形状和在文本框架之间链接文本的所有属性和方法。

Shape 对象定位到文本范围，但可自由浮动，并且可以放置在页面上的任意位置。 InlineShape 对象被视为字符，并定位为文本行中的字符。 可以使用 ConvertToInlineShape() 方法和 ConvertToShape() 方法将形状从一种类型转换为另一种类型。 您可以将图片、 OLE 对象和 ActiveX 控件转换为嵌入式图形。

属性

Adjustments	返回一个 Adjustments 对象，该对象包含指定 Shape 对象中表示自选图形或艺术字的所有调整值的调整值。
AlternativeText	返回或设置与 Web 页中的形状相关联的可选文字。
Anchor	返回一个 Range 对象，该对象代表指定形状的定位范围。
AnchorID	表示对象在绘图层中，如自选图形、 任意多边形、 OLE 对象、 ActiveX 控件或图片。
Application	返回一个 Application 对象，该对象代表 Microsoft Word 应用程序。
AutoShapeType	返回或设置指定 Shape 对象的形状类型，该对象必须表示自选图形，而不是线条或任意多边形绘图。
BackgroundStyle	获取或设置指定形状的背景样式。
Callout	返回一个 CalloutFormat 对象，该对象包含指定形状的标注格式属性。
CanvasItems	返回一个 CanvasShapes 对象，该对象代表绘图画布中形状的集合。
Chart	返回一个 Chart 对象，该对象代表文档中形状集合中的图表。 此为只读属性。
Child	确定形状是否为子形状。
ConnectionSiteCount	仅供内部使用。
Connector	仅供内部使用。
ConnectorFormat	仅供内部使用。
Creator	返回一个 32 位整数，它指示在其中创建指定的对象的应用程序。
Diagram	返回 Diagram 关系图节点所属的对象。
DiagramNode	返回一个 DiagramNode 对象，该对象代表关系图中的节点。
EditID	表示对象在绘图层中，如自选图形、 任意多边形、 OLE 对象、 ActiveX 控件或图片。
Fill	返回一个 FillFormat 对象，该对象包含指定形状的填充格式属性。
Glow	返回一个 GlowFormat 对象，该对象代表形状的发光格式。 此为只读属性。
GroupItems	返回一个 GroupShapes 对象，该对象代表指定组中的各个形状。
HasChart	如此 如果指定的形状包含的图表。 此为只读属性。
HasDiagram	确定形状是否为关系图。
HasDiagramNode	确定形状是否为关系图节点。
HasSmartArt	如果形状上存在 SmartArt 图表，则获取 True 。
Height	返回或设置指定形状的高度（以磅为单位）。
HeightRelative	返回或设置 单个 值，代表形状的相对高度的百分比。 读/写。
HorizontalFlip	指示形状已经水平翻转。
Hyperlink	返回一个 Hyperlink 对象，该对象表示与指定形状关联的超链接。
ID	返回指定对象的类型。
LayoutInCell	返回一个 Integer 类型的值，该值代表表格中的形状是显示在表格内还是表外。
Left	返回或设置一个 单一 的水平位置，以磅为单位指定的形状或形状范围的表示。
LeftRelative	返回或设置 一个 值，该值代表形状左侧的相对位置。 读/写。
Line	返回一个 LineFormat 对象，该对象包含指定形状的线条格式属性。
LinkFormat	返回一个 LinkFormat 对象，该对象表示链接到文件的指定形状的链接选项。
LockAnchor	确定指定 Shape 对象的定位点是否锁定到定位范围。
LockAspectRatio	确定在调整形状大小时是否可以彼此独立地更改形状的高度和宽度，或者它是否保留其原始比例。
Name	返回或设置指定对象的名称。
Nodes	返回一个 ShapeNodes 集合，该集合表示指定形状的几何说明。
OLEFormat	返回一个 OLEFormat 对象，该对象表示 OLE 特征 (指定形状的链接) 。
Parent	返回一个对象，代表指定对象的父对象。
ParentGroup	返回一个 Shape 对象，该对象代表子形状的常见父形状。
PictureFormat	返回一个 PictureFormat 对象，该对象包含指定对象的图片格式属性。
Reflection	返回一个 ReflectionFormat 对象，该对象代表形状的反射格式。 此为只读属性。
RelativeHorizontalPosition	指定形状的水平位置的相对位置。
RelativeHorizontalSize	返回或设置一个 WdRelativeHorizontalSize 常量，该常量代表形状范围相对于的对象。 读/写。
RelativeVerticalPosition	指定形状的垂直位置的相对位置。
RelativeVerticalSize	返回或设置一个 WdRelativeVerticalSize 常量，该常量表示形状的相对垂直大小。 读/写。
Rotation	返回或设置指定的形状绕 z 轴旋转的度数。
RTF	仅供内部使用。
Script	返回一个 Script 对象，该对象表示指定网页上的脚本或代码块。
Shadow	返回一个 ShadowFormat 对象，该对象代表指定形状的阴影格式。
ShapeStyle	获取或设置指定形状的形状样式。
SmartArt	获取一个 SmartArt 对象，该对象提供一种使用与指定形状关联的 SmartArt 的方法。
SoftEdge	返回一个 SoftEdgeFormat 对象，该对象代表形状的软边缘格式。 此为只读属性。
TextEffect	返回一个 TextEffectFormat 对象，该对象包含指定形状的文本效果格式属性。
TextFrame	返回一个 TextFrame 对象，该对象包含指定形状的文本。
TextFrame2	返回一个 TextFrame2 对象，该对象包含指定形状的文本。 此为只读属性。
ThreeD	返回一个 ThreeDFormat 对象，该对象包含指定形状的三维效果的格式属性。
Title	获取或设置一个字符串，该字符串包含指定形状的标题。
Top	返回或设置指定形状的垂直位置（以磅为单位）。
TopRelative	返回或设置 一个 值，代表形状顶部的相对位置。 读/写。
Type	返回图形的类型。
VerticalFlip	确定是否在垂直轴上翻转指定的形状。
Vertices	将指定任意多边形形状的顶点（及贝塞尔曲线的控制点）坐标作为一系列坐标对返回。
Visible	确定指定的对象或应用于该对象的格式是否可见。
Width	返回或设置指定对象的宽度（以磅为单位）。
WidthRelative	返回或设置一个 Single 类型的值，该值代表形状的相对宽度。 读/写。
WrapFormat	返回一个 WrapFormat 对象，该对象包含用于在指定形状周围环绕文本的属性。
ZOrderPosition	返回指定的形状在 z 顺序中的位置。

方法

Activate()	激活指定的对象。
Apply()	适用于已使用 PickUp() 方法复制的指定形状格式。
CanvasCropBottom(Single)	从绘图画布的底部裁剪一定百分比的绘图画布高度。
CanvasCropLeft(Single)	从绘图画布左侧裁剪一定百分比的绘图画布宽度。
CanvasCropRight(Single)	从绘图画布右侧裁剪一定百分比的绘图画布宽度。
CanvasCropTop(Single)	从绘图画布顶部裁剪一定百分比的绘图画布高度。
ConvertToFrame()	将指定的图形转换为图文框。
ConvertToInlineShape()	将文档绘图层的指定图形转换为文字层的嵌入式图形。
Delete()	删除指定的对象。
Duplicate()	创建指定 Shape 对象的副本，在与原始形状的标准偏移量处向 Shapes 集合中添加新的形状区域，然后返回新的 Shape 对象。
Flip(MsoFlipCmd)	水平或垂直翻转一个图形。
IncrementLeft(Single)	将指定形状水平移动指定的磅数。
IncrementRotation(Single)	使指定的形状绕 Z 轴旋转指定的角度。
IncrementTop(Single)	以指定磅数垂直移动指定形状。
PickUp()	复制指定形状的格式。
RerouteConnections()	仅供内部使用。
ScaleHeight(Single, MsoTriState, MsoScaleFrom)	按指定因子缩放形状的高度。
ScaleWidth(Single, MsoTriState, MsoScaleFrom)	按指定因子缩放形状的宽度。
Select(Object)	选择指定的对象。
SetShapesDefaultProperties()	将指定形状的格式应用于该文档的默认形状。 新形状将继承默认形状的许多属性。
Ungroup()	取消组合指定形状中的所有组合形状。
ZOrder(MsoZOrderCmd)	将指定形状移动到集合中的其他形状的前面或后面（即更改 z 顺序中的形状位置）。