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);

پارامترها

DPIDPI مورد استفاده برای rendering. مقدار 72 وقتی سطح zoom برابر 100% باشد، همان نتیجه Acrobat را می‌دهد
StartPageاولین صفحه برای چاپ
EndPageآخرین صفحه برای چاپ
Options0 = خروجی 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صفحات با موفقیت رندر شدند