RenderDocumentToFileA
การเรนเดอร์และการพิมพ์
คำอธิบาย
อักษร A ท้ายชื่อบอกว่าเป็นจุดเรียก DLL แบบ ANSI (char), ส่วน ActiveX/COM เปิดเผยเฉพาะรูปแบบ Unicode พฤติกรรมเหมือน RenderDocumentToFile ทุกอย่าง และอาร์กิวเมนต์สตริงถูกตีความตาม code page ปัจจุบันของ SetAnsiMode
เรนเดอร์บางหน้าจากเอกสารที่เลือกอยู่ลงไฟล์รูปภาพบนดิสก์
ตามค่าเริ่มต้นการเรนเดอร์ใช้ระบบ GDI+ ซึ่งมีให้ใช้ตามค่าเริ่มต้นใน Windows XP ขึ้นไป ตัวเลือก 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 ที่ใช้เรนเดอร์ ค่า 72 จะให้ผลเหมือน Acrobat ตอนระดับซูม 100% |
|---|---|
| StartPage | The first page to print |
| EndPage | The last page to print |
| 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 | เรนเดอร์หน้าสำเร็จแล้ว |