使用形状

本主题讨论如何使用 Aspose.Words 以编程方式处理形状。

Aspose.Words 中的形状表示绘图层中的对象，例如自选图形、文本框、自由格式、OLE 对象、ActiveX 控件或图片。 Word 文档可以包含一种或多种不同的形状。文档的形状由 Shape 类表示。

使用文档生成器插入形状

您可以使用 insert_shape 方法将指定类型和大小的内联形状以及指定位置、大小和文本换行类型的自由浮动形状插入到文档中。 insert_shape 方法允许将 DML 形状插入到文档模型中。文档必须以支持DML形状的格式保存，否则，在保存文档时，此类节点将被转换为VML形状。

以下代码示例演示如何将这些类型的形状插入到文档中：

使用 Aspose.Words，您可以通过 aspect_ratio_locked 属性指定是否锁定形状的纵横比。

以下代码示例演示如何使用 AspectRatioLocked 属性：

您还可以使用 is_layout_in_cell 属性指定形状是显示在表格内部还是表格外部。

以下代码示例演示如何使用 IsLayoutInCell 属性：

DML 形状是使用 insert_shape 方法使用这些形状类型创建的。这些类型不能用于创建 VML 形状。尝试使用 Shape 类的公共构造函数创建形状会引发"NotSupportedException"异常。

以下代码示例展示了如何将这些类型的形状插入到文档中：

使用 Aspose.Words API，您可以获得包含块的形状相对于最顶部形状的锚点的位置和大小（以点为单位）。为此，请使用 bounds_in_points 属性。

以下代码示例演示如何使用 BoundsInPoints 属性：

您可以使用 vertical_anchor 属性指定形状内的文本垂直对齐方式。

以下代码示例演示如何使用 VerticalAnchor 属性：

Aspose.Words 还允许检测 Shape 是否具有 SmartArt 对象。为此，请使用 has_smart_art 属性属性。

以下代码示例演示如何使用 HasSmartArt 属性：

您可以使用 insert_horizontal_rule 方法将水平线形状插入到文档中。

以下代码示例展示了如何执行此操作：

Aspose.Words API 提供 horizontal_rule_format 属性来访问水平线形状的属性。 HorizontalRuleFormat 类公开 height、color、no_shade 等基本属性，用于水平线的格式设置。

以下代码示例演示了如何设置 HorizontalRuleFormat：

Aspose.Words API 提供 Shape.insert_ole_object_as_icon 功能，将嵌入或链接的 OLE 对象作为图标插入到文档中。此功能允许指定图标文件和标题。应使用文件扩展名检测 OLE 对象类型。

下面的代码示例演示了如何设置将 OLE 对象作为 Icon 插入到文档中：

为了正确显示，图标的最大尺寸必须为 32x32。

您可以使用 convert_shape_to_office_math 属性将带有 EquationXML 的形状转换为 Office Math 对象。此属性的默认值对应于 MS Word 行为，即带有方程式 XML 的形状不会转换为 Office 数学对象。

以下代码示例演示如何将形状转换为 Office Math 对象：