RenderDocumentToFileA

رندر و چاپ

توضیحات

حرف پایانی A نقطهٔ ورود DLL یعنی ANSI (char) را نشان می‌دهد؛ سطح ActiveX/COM تنها فرم یونیکد را افشا می‌کند. رفتار با RenderDocumentToFile یکسان است و آرگومان‌های رشته‌ای با code page فعلیِ SetAnsiMode تفسیر می‌شوند

صفحات معینی از سند انتخاب‌شده را به فایل تصویری روی دیسک رندر می‌کند

به‌طور پیش‌فرض rendering از سیستم GDI+ استفاده می‌کند که در Windows XP و نسخه‌های بعدی به‌صورت پیش‌فرض در دسترس است. خروجی Option 10، یعنی TIFF (G4)، فقط در Windows Vista و Windows Server 2008 و نسخه‌های بعدی در دسترس است

رندر با Cairo هم ممکن است؛ از توابع SetCairoFileName و SelectRenderer استفاده کنید

نحو

Delphi

Function DLRenderDocumentToFileA(InstanceID: Integer; DPI: Double; StartPage, EndPage, Options: Integer; FileName: PAnsiChar): Integer;

DLL

int DLRenderDocumentToFileA(int InstanceID, double DPI, int StartPage, int EndPage, int Options, const char * 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صفحات با موفقیت رندر شدند