图像页面布局
图像页面布局
此页面记录 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/ImageDataAPI)混淆——后者是独立的常规文档内容功能,而非页面渲染。
常见问题
| 问题 | 原因 | 修复 |
|---|---|---|
没有方法接受 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) |