RenderPagesToFiles
Rendering and printing
תיאור
מעבד את דפי המסמך הנבחרים המתוארים על ידי PageRanges לקבצי תמונה נפרדים.
הפונקציה מקבלת את אותם ערכי Options של עיבוד כמו RenderPageToFile ו-RenderDocumentToFile, אך 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 | מספר הדפים שעובדו בהצלחה לפני השלמה או השגיאה הראשונה. |