TPDFlibPrinter
الطباعة، VCL، إنشاء المستندات
الوصف
يوفر واجهة مكوّن بدورة الحياة المألوفة BeginDoc وCanvas وNewPage وEndDoc وAbort بينما ينشئ مستند PDF بدلًا من إرسال مهمة طابعة فعلية
التصريح
Uses PDFlibPDFPrinter;
TPDFlibPrinter = Class(TComponent)المعاملات
BeginDoc | يبدأ مستند PDF جديدًا ويكشف أول صفحة عبر Canvas |
|---|---|
NewPage | يثبّت لوح الرسم الحالي كصفحة PDF ويفتح لوح الصفحة التالي |
EndDoc | يثبّت الصفحة الأخيرة ويكتب FileName عندما أُسندت وجهة |
Abort | يتخلى عن المهمة النشطة دون كتابة ملف وجهتها ويعيد المكون إلى مستند فارغ |
SetPageSize | يضبط أبعاد الورق الطولية بنقاط PDF قبل BeginDoc |
الخصائص
Canvas | لوح VCL النشط بين BeginDoc وEndDoc أو Abort |
|---|---|
FileName | مسار إخراج PDF اختياري؛ تحفظ القيمة الفارغة النتيجة في LibraryInstance فقط |
Title | عنوان المستند المطبق عندما تبدأ المهمة |
DPI | دقة إحداثيات اللوح من 24 إلى 2400، وتؤول إلى 96 |
CanvasOptions | وضع استيراد اللوح من -1 إلى 4، ويؤول إلى وضع المتجهات 2 |
Orientation | bytes تقدير متحفظ للسجلات المحفوظة والمصفوفات الديناميكية وحمولات السلاسل |
PaperWidth, PaperHeight | أبعاد ورق طولية من 1 إلى 14400 نقطة PDF |
PageWidth, PageHeight | أبعاد نشطة للقراءة فقط ببكسلات اللوح بعد تحويل DPI والاتجاه |
PageWidthPoints, PageHeightPoints | أبعاد نشطة للقراءة فقط بنقاط PDF |
PageNumber | الصفحة الحالية أثناء مهمة ويبدأ العد من 1، والصفر أثناء الخمول |
Printing, Aborted | حالة دورة حياة للقراءة فقط |
LibraryInstance | مثيل TPDFlib المملوك لفحص ملف PDF المكتمل أو معالجته إضافيًا |
LastErrorCode | رمز خطأ المكتبة الأساسي من أحدث عملية PDF |
مثال
Printer := TPDFlibPrinter.Create(nil);
try
Printer.FileName := 'report.pdf';
Printer.BeginDoc;
Printer.Canvas.TextOut(72, 72, 'First page');
Printer.NewPage;
Printer.Canvas.TextOut(72, 72, 'Second page');
Printer.EndDoc;
finally
Printer.Free;
end;ملاحظات
لا يمكن لخصائص الإعداد أن تتغير أثناء مستند نشط، وإساءة استخدام دورة الحياة ترفع EPDFlibPrinter
يملك المكون مكتبته ولوحته وينشئ مستندًا مستقلًا لكل مهمة ويحفظ المستند المكتمل لعمليات واجهة لاحقة ولا يفتح حوار طباعة أبدًا ولا يلمس مجدول طباعة نظام التشغيل
استخدم try/except حول مهمة واستدعِ Abort فقط أثناء بقاء المهمة نشطة؛ وتنهي عمليات التحويل الداخلية الفاشلة المهمة وتضبط Aborted