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 | 以逗號分隔的頁面範圍清單;使用空字串可彩現所有頁面 |
| 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 | 完成或遇到第一個錯誤前成功彩現的頁數 |