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 | 完成或遇到第一個錯誤前成功彩現的頁數 |