RenderPagesToFilesA

渲染和打印

描述

末尾的 A 表示 ANSI(char)DLL 入口点,ActiveX/COM 接口仅公开 Unicode 形式。其行为与 RenderPagesToFiles 相同,字符串参数会按照当前的 SetAnsiMode 代码页进行解释

将选定文档中由 PageRanges 指定的页面渲染为独立图像文件

本函数接受与 RenderPageToFile 和 RenderDocumentToFile 相同的渲染 Options 值,但 PageRanges 可选择不连续的页面范围,例如 1,3,7-9、Odd 或 Even 2-20

若 FileName 中包含 %p,该占位符将被替换为源页面编号;若 FileName 不含 %p,则源页面编号将自动插入到文件扩展名之前

在活动渲染器支持的情况下,实现会在选定页面列表中复用同一渲染器,从而避免每页单独调用 RenderPageToFile 所带来的初始化开销

语法

Delphi

Function DLRenderPagesToFilesA(InstanceID: Integer; DPI: Double; PageRanges: PAnsiChar; Options: Integer; FileName: PAnsiChar): Integer;

DLL

int DLRenderPagesToFilesA(int InstanceID, double DPI, const char * PageRanges, int Options, const char * 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在渲染完成或首次出错前成功渲染的页面数