Shapes 接口

定义

命名空间:

Microsoft.Office.Interop.Word

程序集:

Microsoft.Office.Interop.Word.dll

对象的集合 Shape ，这些对象表示文档中的所有形状或文档中的所有页眉和页脚中的所有形状。

public interface class Shapes : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("0002099F-0000-0000-C000-000000000046")]
public interface Shapes : System.Collections.IEnumerable

type Shapes = interface
    interface IEnumerable

Public Interface Shapes
Implements IEnumerable

属性

GuidAttribute

实现

IEnumerable

注解

每个 Shape 对象代表对象在绘图层中，如自选图形、 任意多边形、 OLE 对象或图片。

注意 如果要处理文档中的一部分形状（例如，仅对文档中的自选图形或仅对所选形状执行某些操作），则必须构造包含 ShapeRange 要处理的形状的集合。

Shapes使用 属性可返回 Shapes 集合。

注意 如果要同时对文档上的所有形状执行 (操作（如删除或设置属性) ），请使用 Range(Object) 方法创建 ShapeRange 对象，该对象包含 Shapes 集合中的所有形状，然后将相应的属性或方法应用于 ShapeRange 对象。

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

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

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

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

文档中Count此集合的 属性仅返回main文章中的项数。 若要计算所有页眉和页脚中的形状，请将 Shapes 集合与任何 HeaderFooter 对象一起使用。

属性

Application	返回一个 Application 对象，该对象代表 Microsoft Word 应用程序。
Count	返回指定集合中的项数。
Creator	返回一个 32 位整数，它指示在其中创建指定的对象的应用程序。
Item[Object]	返回集合中的单个对象。
Parent	返回一个对象，代表指定对象的父对象。

方法

AddCallout(MsoCalloutType, Single, Single, Single, Single, Object)	向文档添加无边框线条标注。 返回一个 Shape 对象，该对象表示标注并将其添加到集合。Shapes
AddCanvas(Single, Single, Single, Single, Object)	在文档中添加绘图画布。 返回一个 Shape 对象，该对象代表绘图画布并将其添加到集合中 Shapes 。
AddChart(XlChartType, Object, Object, Object, Object, Object)	此对象、成员或枚举已被弃用并且不适合在您的代码中使用。
AddChart2(Int32, XlChartType, Object, Object, Object, Object, Object, Object)	向文档添加图表。 返回一个 Shape 对象，该对象代表图表并将其添加到指定的集合。
AddConnector(MsoConnectorType, Single, Single, Single, Single)	仅供内部使用。
AddCurve(Object, Object)	返回一个 Shape 对象，该对象代表文档中的贝塞尔曲线。
AddDiagram(MsoDiagramType, Single, Single, Single, Single, Object)	返回一个 Shape 对象，该对象代表文档中新创建的关系图。
AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object)	向文档添加文本标签。 返回一个 Shape 对象，该对象代表文本标签并将其添加到集合中 Shapes 。
AddLine(Single, Single, Single, Single, Object)	向文档添加一行。 返回一个 Shape 对象，该对象代表行并将其添加到集合中 AddCallout(MsoCalloutType, Single, Single, Single, Single, Object) 。
AddOLEControl(Object, Object, Object, Object, Object, Object)	创建一个 ActiveX 控件（以前称为 OLE 控件）。 返回 Shape 表示新 ActiveX 控件的 对象。
AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	创建一个 OLE 对象。 返回 Shape 表示新 OLE 对象的 对象。
AddPicture(String, Object, Object, Object, Object, Object, Object, Object)	在文档中添加一幅图片。 返回一个 Shape 对象，该对象代表图片并将其添加到集合中 Shapes 。
AddPolyline(Object, Object)	向文档添加打开或关闭的多边形。 返回一个 Shape 对象，该对象代表多边形并将其添加到集合中 Shapes 。
AddShape(Int32, Single, Single, Single, Single, Object)	向某文档中添加一个自选图形。 返回一个 Shape 对象，该对象代表自选图形并将其添加到集合中 Shapes 。
AddSmartArt(SmartArtLayout, Object, Object, Object, Object, Object)	将指定 SmartArt 图形插入活动文档。
AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)	向文档添加文本框。 返回一个 Shape 对象，该对象代表文本框并将其添加到集合中 Shapes 。
AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)	向文档添加艺术字形状。 返回一个 Shape 对象，该对象代表艺术字并将其添加到集合中 Shapes 。
AddWebVideo(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)	向文档添加新的 Web 视频。
BuildFreeform(MsoEditingType, Single, Single)	建立任意多边形对象。 返回一个 FreeformBuilder 对象，该对象表示正在生成的任意多边形。
GetEnumerator()	对象的集合 Shape ，这些对象表示文档中的所有形状或文档中的所有页眉和页脚中的所有形状。
Range(Object)	返回 对象 ShapeRange 。
SelectAll()	选择main文章、画布或文档的页眉和页脚中的所有形状。