图像页面布局

图像页面布局

图像页面布局

此页面记录 MultiPageLayout 配置类及其相关的图像渲染枚举,并解释为何它们在此版本中没有功能性的保存路径。

Aspose.Words .NET 的 FOSS 包含一小套模型类,用于描述在渲染为单个基于图像的输出时,多个文档页面的排列方式 — MultiPageLayout 以及其支持的枚举。本版本不包含页面布局和渲染引擎本身(参见 功能与特性 以及 产品概览),因此这些类型在公共 API 表面上作为配置原语存在,但在此构建中没有可消耗它们的保存路径。


MultiPageLayout

MultiPageLayout 是一个 sealed 类,其静态工厂方法各自构建不同的多页布局:Vertical(verticalGap) 将页面自上而下堆叠,并在它们之间保持给定的间距;Horizontal(horizontalGap) 将页面并排放置,从左到右;Grid(columns, horizontalGap, verticalGap) 按指定列数在网格中左至右、上至下排列页面;TiffFrames() 将每页保持为单独的帧,而不是合并为一幅图像;SinglePage() 只渲染单页。构建完成后,MultiPageLayout 实例会公开 BackColor 和 BorderColor(均为 Color)以及 BorderWidth(float),用于为合成输出设定样式。


相关渲染枚举

另外还有三个枚举描述相同的“文档页面作为图像”领域:ImageColorMode(None、Grayscale、BlackAndWhite)控制生成页面图像的颜色模式;ImagePixelFormat 列出生成页面图像可用的像素格式(例如 Format24BppRgb 和 Format32BppArgb);ImageBinarizationMethod(Threshold、FloydSteinbergDithering)指定图像如何转换为黑白。与 MultiPageLayout 类似,这些枚举在 API 表面上定义,但在此版本中尚未与任何保存选项类关联——此 FOSS 构建不包括图像、PDF 或 XPS 导出。


技巧与最佳实践

  • 在本版中,请将 MultiPageLayout 及其相关枚举视为仅供参考 — 公共的 API 界面中没有 Save() 路径可以消耗 MultiPageLayout 实例来实际生成图像。
  • 如果您的工作流需要将 Word 文档渲染为 TIFF、PNG、JPEG 或其他图像格式,请使用商业版 Aspose.Words for .NET,其中包括这些类型所设计的完整渲染引擎。
  • 不要把此图像页面布局区域与在文档中嵌入图片(即 Shape / ImageData API)混淆——后者是独立的常规文档内容功能,而非页面渲染。

常见问题

问题原因修复
没有方法接受 MultiPageLayout 实例此版本不包括 image/PDF/XPS 渲染引擎使用商业 Aspose.Words 用于 .NET 的页面渲染和图像导出
Document.Save() 到图像扩展名失败此版本不包含图像/PDF/XPS 渲染引擎,该引擎是基于图像的保存格式所必需的请改为保存为 DOCX、DOCM、DOTX、DOTM、Flat OPC、Markdown 或纯文本

FAQ

我可以使用 MultiPageLayout 将文档导出为多页 TIFF 吗?

本版不支持。MultiPageLayout 及其支持的枚举(ImageColorMode、ImagePixelFormat、ImageBinarizationMethod)在 API 界面中存在,但用于消耗它们的图像渲染保存管道并未包含在此 FOSS 构建中。

如果这个类在这里没有功能,它为什么会存在?

Aspose.Words FOSS for .NET 是经过简化为免费核心的真正 Aspose.Words 代码库,而不是重写——一些与已移除的渲染引擎绑定的模型层类仍然被编译进库中,尽管目前没有受支持的保存路径使用它们。

在文档中嵌入图片也算作排除吗?

不——通过 Shape 和 ImageData 在文档内容中插入和格式化图片是正常且受支持的文档编辑功能。仅排除将整页渲染为图像格式的情况。


API Reference 摘要

类 / 枚举描述
MultiPageLayout配置多个页面如何合并为一个基于图像的输出(Vertical、Horizontal、Grid、TiffFrames、SinglePage)
ImageColorMode生成的页面图像的颜色模式(None、Grayscale、BlackAndWhite)
ImagePixelFormat生成页面图像的像素格式选项
ImageBinarizationMethod黑白转换方法(Threshold, FloydSteinbergDithering)
 中文