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逗号分隔的页面范围列表。传入空字符串则渲染所有页面
Options0 = 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在渲染完成或首次出错前成功渲染的页面数