وثائق PDFiumPas

Active الخاصية

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.
المكون: TPdf  ·  الوحدة: PDFium
يفتح مستند PDF المحدد أو يغلقه

الصياغة

property Active: Boolean; // default False

الوصف

عند تعيين Active إلى True يُفتح مستند PDF المحدد في FileName ويُحمَّل، مع استخدام Password إذا كان المستند مشفرا. وعند تعيينها إلى False يُغلق المستند وتُحرَّر كل موارد PDFium المرتبطة به، مثل الصفحات والخطوط ومقابض النماذج وصفحات النص

يمكنك أيضا استدعاء LoadDocument مباشرة بدلا من تبديل هذه الخاصية. عند إسناد FileName بينما تكون Active بالفعل True يُعاد تحميل المستند تلقائيا من المسار الجديد، وهي الطريقة الموصى بها للتبديل بين ملفات PDF داخل مثيل واحد من TPdf

إذا تعذر فتح الملف، سواء بسبب مسار خاطئ أو كلمة مرور غير صحيحة أو ملف PDF تالف أو نموذج XFA-only غير مدعوم، يُرفع الاستثناء EPdfError. لف الإسناد داخل كتلة try/except لمعالجة هادئة للأخطاء، وافحص E.Message للحصول على وصف خطأ PDFium

ملاحظات

مثال

Pdf1.FileName := 'C:\docs\report.pdf';
Pdf1.Password := ''; // leave empty if not encrypted
try
  Pdf1.Active := True;
  ShowMessage('Pages: ' + IntToStr(Pdf1.PageCount));
except
  on E: EPdfError do
    ShowMessage('Cannot open: ' + E.Message);
end;

انظر أيضا

FileName, Password, LoadDocument, PageCount, LoadLibrary, CreateDocument