RenderPagesToFiles
رندر و چاپ
شرح
صفحات سند انتخابشده را که توسط 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 | تعداد صفحاتی که با موفقیت قبل از تکمیل یا اولین خطا رندر شدهاند |