ShapeRange 接口

定义

命名空间:

Microsoft.Office.Interop.Word

程序集:

Microsoft.Office.Interop.Word.dll

代表一个形状范围，即某个文档中的一组形状。

public interface class ShapeRange : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("000209B5-0000-0000-C000-000000000046")]
public interface ShapeRange : System.Collections.IEnumerable

type ShapeRange = interface
    interface IEnumerable

Public Interface ShapeRange
Implements IEnumerable

属性

GuidAttribute

实现

IEnumerable

注解

一个形状范围可以只包含一个形状，也可以包含该文档中的所有形状。 可以包含所需的任何形状（从文档中的所有形状或所选内容中的所有形状中选择）来构造形状范围。 例如，可以构造一个 ShapeRange 集合，该集合包含文档、 文档中所有选定的图形或文档中的所有任意多边形中的前三个形状。

注意 可以对 对象执行大多数操作，也可以对只包含一个 Shape 形状的 ShapeRange 对象执行。 某些操作，一个 ShapeRange 对象，该对象包含多个形状，在执行时将导致错误。

使用 Shapes.Range (index) ，其中 index 是形状的名称或索引号或包含形状名称或索引号的数组，可返回代表文档上一组形状的 ShapeRange 集合。 可以编程方式使用数组来构造名称或索引号数组。

虽然可以使用 Range(Object) 方法返回任意数量的形状，但如果只想返回集合的单个成员，则使用 Item[Object] 方法会更简单。 例如，Shapes(1) 比 Shapes.Range(1) 简单。

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

Align(MsoAlignCmd, Int32)使用 、 Distribute(MsoDistributeCmd, Int32)或 ZOrder(MsoZOrderCmd) 方法可相对于彼此或相对于文档定位一组形状。

Group()使用 、 Regroup()或 Ungroup() 方法创建和使用从形状范围形成的单个形状。 GroupItems Shape 对象的 属性返回 GroupShapes 对象，该对象表示组合成一个形状的所有形状。

录制形状时， ShapeRange 记录器始终使用 属性。

ShapeRange 对象不包括 InlineShape 对象。

属性

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

方法

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