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