与文档分开渲染形状

处理文档时，一项常见任务是提取文档中找到的所有图像并将其导出到外部位置。使用 Aspose.Words API，这项任务变得简单，它已经提供了提取和保存图像数据的功能。但是，有时您可能想要类似地提取由不同类型的绘图对象表示的其他类型的图形内容，例如包含段落、箭头形状和小图像的文本框。没有直接的方法来呈现该对象，因为它是各个内容元素的组合。您还可能会遇到这样的情况：内容被组合在一起形成看起来像单个图像的对象。

Aspose.Words 提供了提取此类内容的功能，就像从形状中提取简单图像作为渲染内容一样。本文介绍如何利用此功能独立于文档渲染形状。

Aspose.Words 中的形状类型

文档绘图图层中的所有内容均由 Aspose.Words 文档对象模块 (DOM) 中的 Shape 或 GroupShape 节点表示。此类内容可以是文本框、图像、自选图形、OLE 对象等。某些字段也可以作为形状导入，例如 INCLUDEPICTURE 字段。

一个简单的图像由ShapeType.Image的Shape节点表示。该形状节点没有子节点，但可以通过 Shape.ImageData 属性访问该形状节点中包含的图像数据。另一方面，形状也可以由许多子节点组成。例如，由 ShapeType.TextBox 属性表示的文本框形状可以由许多节点组成，例如 Paragraph 和 Table。大多数形状可以包含 Paragraph 和 Table 块级节点。这些节点与主体中出现的节点相同。形状始终是某个段落的一部分，要么直接内联，要么锚定到 段落，，但"浮动"在文档页面的任何位置。

文档还可以包含组合在一起的形状。通过选择多个对象并单击右键菜单中的"Group"，可以在 Microsoft Word 中启用 Grouping。

在 Aspose.Words 中，这些形状组由 GroupShape 节点表示。也可以以相同的方式调用它们以将整个组渲染为图像。

DOCX 格式可以包含特殊类型的图像，例如图表或图表。这些形状也通过 Aspose.Words 中的 Shape 节点来表示，Aspose.Words 也提供了类似的方法将它们呈现为图像。根据设计，一个形状不能包含另一个形状作为子项，除非该形状是图像 (ShapeType.Image)。例如，Microsoft Word 不允许您将一个文本框插入另一个文本框。

上述形状类型提供了一种特殊的方法来通过 ShapeRenderer 类渲染形状。通过 GetShapeRenderer 方法或通过将 Shape 传递给 ShapeRenderer 类的构造函数来检索 Shape 或 GroupShape 的 ShapeRenderer 类实例。此类提供对成员的访问，允许将形状呈现为以下内容：

• 使用Save方法重载磁盘上的文件
• 使用 Save 方法重载进行流式传输
• 使用 RenderToSize 和 RenderToScale 方法的 .NET 图形对象

渲染 Shape 时，它必须是文档层次结构的一部分。如果 Shape 不是文档树的一部分，则调用 ShapeRenderer 方法后渲染的输出将为空白。

渲染到文件或流

Save 方法提供了将形状直接渲染到文件或流的重载。两个重载都接受 ImageSaveOptions 类的实例，该实例允许定义用于渲染形状的选项。这与 Document.Save 方法的工作方式相同。即使此参数是必需的，您也可以传递 null 值，指定没有自定义选项。

该形状可以以 SaveFormat 枚举中指定的任何图像格式导出。例如，图像可以通过指定 SaveFormat.Jpeg 枚举呈现为光栅图像（例如 JPEG），或者通过指定 SaveFormat.Emf 呈现为矢量图像（例如 EMF）。

下面的代码示例说明了将形状与文档分开渲染到 EMF 图像，并保存到磁盘：

下面的代码示例说明了将形状与文档分开渲染为 JPEG 图像，并保存到流中：

ImageSaveOptions 类允许您指定控制图像渲染方式的各种选项。上述功能可以以相同的方式应用于 GroupShape 和 Shape 节点。

渲染到 .NET 图形对象

直接渲染到 Graphics 对象允许您定义自己的设置和 Graphics 对象的状态。常见场景涉及将形状直接渲染到从 Windows 表单或位图检索的 Graphics 对象中。当渲染 Shape 节点时，这些设置将影响形状外观。例如，您可以使用 Graphics 对象的 RotateTransform 或 ScaleTransform 方法来旋转或缩放形状。

下面的示例展示了如何将形状与文档分开渲染到 .NET Graphics 对象，并对渲染的图像应用旋转：

与 RenderToSize 方法类似，从 NodeRendererBase 继承的 渲染到尺寸 方法对于创建文档内容的缩略图非常有用。形状大小是通过构造函数指定的。 RenderToSize 方法接受 Graphics 对象、图像位置的 X 和 Y 坐标以及将绘制到 Graphics 对象上的图像大小（宽度和高度）。

可以使用从 NodeRendererBase 类继承的 ShapeRenderer.RenderToScale 方法将 Shape 呈现为一定比例。这与接受相同主要参数的 Document.RenderToScale 方法类似。这两种方法之间的区别在于，使用 ShapeRenderer.RenderToScale 方法时，您选择一个在渲染过程中缩放形状的浮点值，而不是文字大小。如果浮点值等于 1.0，则会导致形状以其原始大小的 100% 渲染。浮点值 0.5 会将图像大小减小一半。

渲染形状图像

Shape 类表示绘图层中的对象，例如自选图形、文本框、自由格式、OLE 对象、ActiveX 控件或图片。使用 Shape 类，您可以创建或修改 Microsoft Word 文档中的形状。形状的一个重要属性是它的 ShapeType。不同类型的形状在 Word 文档中可以具有不同的功能。例如，只有图像和 OLE 形状可以在其中包含图像，而大多数形状只能包含文本。

以下示例演示如何将 Shape 图像与文档分开渲染为 JPEG 图像并将其保存到磁盘：

检索形状大小

ShapeRenderer 类还提供通过 GetSizeInPixels 方法检索形状大小（以像素为单位）的功能。此方法接受两个浮点（单个）参数 - 比例和 DPI，它们用于在渲染形状时计算形状大小。该方法返回 Size 对象，其中包含计算出的尺寸的宽度和高度。当需要提前知道渲染形状的大小时（例如从渲染输出创建新位图时），这非常有用。

下面的示例展示了如何使用要渲染的形状的宽度和高度创建新的位图和图形对象：

使用 RenderToSize 或 RenderToScale 方法时，渲染的图像大小也会在 SizeF 对象中返回。可以将其分配给变量并在必要时使用。

SizeInPoints 属性返回以点为单位测量的 Shape 大小（请参阅 ShapeRenderer。结果是包含宽度和高度的 SizeF 对象。