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);
پارامترها
| 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 | صفحات با موفقیت رندر شدند |