RenderDocumentToFile
رندر و چاپ
توضیحات
صفحات معینی از سند انتخابشده را به فایل تصویری روی دیسک رندر میکند
بهطور پیشفرض rendering از سیستم GDI+ استفاده میکند که در Windows XP و نسخههای بعدی بهصورت پیشفرض در دسترس است. خروجی Option 10، یعنی TIFF (G4)، فقط در Windows Vista و Windows Server 2008 و نسخههای بعدی در دسترس است
رندر با Cairo هم ممکن است؛ از توابع SetCairoFileName و SelectRenderer استفاده کنید
نحو
Delphi
Function TPDFlib.RenderDocumentToFile(DPI: Double; StartPage, EndPage, Options: Integer; Const FileName: WideString): Integer;
ActiveX
Function PDFlib::RenderDocumentToFile(DPI As Double, StartPage As Long, EndPage As Long, Options As Long, FileName As String) As Long
DLL
int DLRenderDocumentToFile(int InstanceID, double DPI, int StartPage, int EndPage, int Options, const wchar_t * FileName);
پارامترها
| DPI | DPI مورد استفاده برای rendering. مقدار 72 وقتی سطح zoom برابر 100% باشد، همان نتیجه Acrobat را میدهد |
|---|---|
| StartPage | اولین صفحه برای چاپ |
| EndPage | آخرین صفحه برای چاپ |
| Options | 0 = خروجی BMP 1 = خروجی JPEG 2 = خروجی WMF 3 = خروجی EMF 4 = خروجی EPS 5 = خروجی PNG 6 = خروجی GIF 7 = خروجی TIFF 8 = خروجی EMF+ 9 = خروجی HTML5 10 = خروجی G4 TIFF مسیر و نام فایل؛ هر صفحه در فایل جداگانهای ذخیره میشود. اگر این پارامتر "%p" داشته باشد با شمارهٔ صفحه جایگزین میشود، وگرنه شمارهٔ صفحه پیش از پسوند به انتهای نام فایل اضافه میشود. مثلاً اگر FileName برابر "output.jpg" باشد و صفحهٔ 10 رندر شود، تصویر در فایلی به نام "output10.jpg" ذخیره میشود. اگر FileName برابر "page%poutput.bmp" باشد و صفحهٔ 5 رندر شود، تصویر در فایلی به نام "page5output.bmp" ذخیره میشود |
| FileName |
مقادیر بازگشتی
| 0 | صفحات با موفقیت رندر نشدند؛ معمولاً به دلیل خارجبودن پارامتر StartPage یا EndPage از بازه |
|---|---|
| 1 | صفحات با موفقیت رندر شدند |