property Active: Boolean; // default False
Wenn Sie Active auf True setzen, öffnet und lädt die Komponente das über FileName angegebene PDF-Dokument und verwendet dabei Password, falls das Dokument verschlüsselt ist. Bei False wird das Dokument geschlossen und alle zugehörigen PDFium-Ressourcen (Seiten, Fonts, Formular-Handles, Textseiten) werden freigegeben
Sie können statt dieser Eigenschaft auch LoadDocument direkt aufrufen; es löst bei einem Fehler eine EPdfError aus. FileName und Password lassen sich nur zuweisen, während die Komponente inaktiv ist — ein Dokumentwechsel innerhalb einer TPdf-Instanz heißt also: Active auf False setzen, den neuen Pfad zuweisen und Active wieder auf True setzen
Lässt sich die Datei nicht öffnen (falscher Pfad, falsches Kennwort, beschädigtes PDF oder nicht unterstütztes XFA-only-Formular), löst das Setzen von Active auf True keine Ausnahme aus: Die Komponente bleibt einfach inaktiv. Prüfen Sie Active nach der Zuweisung und lesen Sie LastLoadReport, dessen Status dann plsFailed ist und dessen ErrorMessage den Fehler beschreibt
True-Setzen von Active bei Bedarf geladen — siehe LoadLibrary, falls Sie sie aus einem eigenen Pfad vorladen wollenPdfView1.Pdf := Pdf1 und danach Pdf1.Active := True, um das Dokument zu öffnen und die erste Seite zu rendernActive := False) macht alle zuvor von indizierten Eigenschaften (Annotation, Bookmark, FormFieldInfo usw.) zurückgegebenen Records ungültig — heben Sie sie nicht über eine Öffnen/Schließen-Zyklen hinweg auf
Pdf1.FileName := 'C:\docs\report.pdf';
Pdf1.Password := ''; // leave empty if not encrypted
Pdf1.Active := True;
if Pdf1.Active then
ShowMessage('Pages: ' + IntToStr(Pdf1.PageCount))
else
ShowMessage('Cannot open: ' + Pdf1.LastLoadReport.ErrorMessage);