PDFium Delphi Component Docs

Active Eigenschaft

Komponente: TPdfView  ·  Unit: PDFium
Aktiviert oder deaktiviert den Viewer, öffnet das gebundene PDF-Dokument und rendert die ausgewählte Seite.

Syntax

property Active: Boolean; // default False

Description

Wer Active auf True setzt, weist den Viewer an, das Dokument zu laden, auf das die zugeordnete Pdf-Komponente verweist, die durch PageNumber bezeichnete Seite zu öffnen und ein Repaint anzustoßen. Auf False gesetzt schließt er die Seite, gibt das gecachte Textseiten-Handle frei, wirft die Find-Sitzung weg und leert den sichtbaren Bereich

Active ist der Hauptschalter des Viewers. Dokumentbezogene Eigenschaften wie PageCount, PageWidth, PageLabel und die indizierten Accessors (Character, Bitmap, WebLink usw.) liefern nur dann aussagekräftige Werte, wenn Active True ist und die verknüpfte Pdf-Instanz ein Dokument geladen hat

Ist Pdf nil, erzeugt und besitzt der Viewer beim ersten True-Setzen von Active eine interne TPdf-Instanz; ein minimales Programm kann also schlicht PdfView1.Pdf.FileName := ...; PdfView1.Active := True; aufrufen, nachdem es auf eine Datei gezeigt hat

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