PDFium Delphi Component Docs

Active الخاصية

Component: TPdfView  ·  Unit: PDFium
يُفعّل العارض أو يعطّله، فيفتح مستند PDF المرتبط ويعرض الصفحة المحددة

Syntax

property Active: Boolean; // default False

Description

الإسناد Active بقيمة True يوجّه العارض إلى تحميل المستند المشار إليه عبر مكوّن Pdf المرتبط، وفتح الصفحة التي يحددها PageNumber، وإطلاق إعادة رسم. وإسناده بقيمة False يغلق الصفحة، ويحرر مقبض صفحة النص المخزن، ويلغي جلسة البحث، ويمسح المنطقة المرئية

Active هو المفتاح الرئيس للعارض. فالخصائص المتعلقة بالمستند مثل PageCount و PageWidth و PageLabel، والموصلات المفهرسة (Character و Bitmap و WebLink وغيرها) لا تعيد قيمًا مفيدة إلا بينما Active بقيمة True ونسخة Pdf المرتبطة عليها مستند محمَّل

إذا كان Pdf بقيمة nil ينشئ العارض نسخة TPdf داخلية ويمتلكها أول مرة يُسند فيها Active بقيمة True، فيكفي أن يستدعي برنامج بسيط PdfView1.Pdf.FileName := ...; PdfView1.Active := True; بعد توجيهه إلى ملف

Remarks

Example

// Bind to an explicit TPdf and open a file.
PdfView1.Pdf := Pdf1;
Pdf1.FileName := 'C:\docs\sample.pdf';
PdfView1.Active := True;

// React to open/close in code.
if PdfView1.Active then
  StatusBar1.SimpleText := Format('%d pages', [PdfView1.PageCount])
else
  StatusBar1.SimpleText := 'No document loaded';

// Close the viewer.
PdfView1.Active := False;

See Also

Pdf, PageNumber, PageCount, ReloadPage, TPdf.Active