DARenderPageToFileA
直接访问功能、渲染和打印
描述
后缀 A 表示 ANSI(char)DLL 入口点;ActiveX/COM 接口仅公开 Unicode 形式,其行为与 DARenderPageToFile 相同,字符串参数使用当前 SetAnsiMode 代码页进行解释
将指定文档中的指定页面渲染为图像,并将图像数据作为文件保存到磁盘
默认情况下,渲染使用 Windows XP 及更高版本提供的 GDI+ 系统
选项 10 的 TIFF(G4)输出仅适用于 Windows Vista、Windows Server 2008 及更高版本
也可以使用 Cairo 渲染,请使用 SetCairoFileName 和 SelectRenderer
functions.
语法
Delphi
Function DLDARenderPageToFileA(InstanceID, FileHandle, PageRef, Options: Integer; DPI: Double; FileName: PAnsiChar): Integer;
DLL
int DLDARenderPageToFileA(int InstanceID, int FileHandle, int PageRef, int Options, double DPI, const char * FileName);
参数
| FileHandle | 由 DAOpenFile、DAOpenFileReadOnly 或 DAOpenFromStream 函数返回的句柄 |
|---|---|
| PageRef | DAFindPage 或 DANewPage 函数返回的页面引用 |
| Options | 0 = BMP 输出 1 = JPEG 输出 2 = WMF 输出 3 = EMF 输出 4 = EPS 输出 5 = PNG 输出 6 = GIF 输出 7 = TIFF 输出 8 = EMF+ 输出 9 = HTML5 输出 10 = G4 TIFF 输出 |
| DPI | 渲染页面时使用的 DPI。值超过 300 会导致过高的内存使用量 |
| FileName | 用于存储已渲染页面图像数据的待创建文件路径和文件名 |
返回值
| 0 | 无法渲染页面,请检查 FileHandle 和 PageRef 参数值 |
|---|---|
| 1 | 页面已正确渲染,图像文件已保存到磁盘,无法将文件写入磁盘 2 |