RenderPagesToFiles
渲染和打印
描述
将选定文档中由 PageRanges 指定的页面渲染为独立图像文件
本函数接受与 RenderPageToFile 和 RenderDocumentToFile 相同的渲染 Options 值,但 PageRanges 可选择不连续的页面范围,例如 1,3,7-9、Odd 或 Even 2-20
若 FileName 中包含 %p,该占位符将被替换为源页面编号;若 FileName 不含 %p,则源页面编号将自动插入到文件扩展名之前
在活动渲染器支持的情况下,实现会在选定页面列表中复用同一渲染器,从而避免每页单独调用 RenderPageToFile 所带来的初始化开销
语法
Delphi
Function TPDFlib.RenderPagesToFiles(DPI: Double; Const PageRanges: WideString; Options: Integer; Const FileName: WideString): Integer;
ActiveX
Function PDFlib::RenderPagesToFiles(DPI As Double, PageRanges As String, Options As Long, FileName As String) As Long
DLL
int DLRenderPagesToFiles(int InstanceID, double DPI, const wchar_t * PageRanges, int Options, const wchar_t * FileName);
参数
| DPI | 渲染每页时使用的 DPI 分辨率 |
|---|---|
| PageRanges | 逗号分隔的页面范围列表。传入空字符串则渲染所有页面 |
| Options | 0 = BMP 输出 1 = JPEG 输出 2 = WMF 输出 3 = EMF 输出 4 = EPS 输出 5 = PNG 输出 6 = GIF 输出 7 = TIFF 输出 8 = EMF+ 输出 9 = HTML5 输出 10 = TIFF (G4) 输出 |
| FileName | 输出文件名或文件名模板。在需要插入源页面编号的位置使用 %p |
返回值
| 0 | 未渲染任何页面 |
|---|---|
| >0 | 在渲染完成或首次出错前成功渲染的页面数 |