PDFium Delphi Component Docs

Active Propriété

Composant: TPdf  ·  Unit: PDFium
Ouvre ou ferme le document PDF sélectionné

Syntax

property Active: Boolean; // default False

Description

Définir Active à True ouvre et charge le document PDF spécifié par FileName, en utilisant Password si le document est chiffré. Lorsqu’il est défini à False, le document est fermé et toutes les ressources PDFium associées (pages, polices, handles de formulaire, pages de texte) sont libérées

Vous pouvez aussi appeler LoadDocument directement au lieu de basculer cette propriété ; il lève une EPdfError en cas d’échec. FileName et Password ne peuvent être affectés que lorsque le composant est inactif, si bien que changer de document sur une même instance TPdf signifie passer Active à False, affecter le nouveau chemin, puis repasser Active à True

Affecter True à Active ne lève pas d’exception lorsque le fichier ne peut pas être ouvert (chemin erroné, mauvais mot de passe, PDF corrompu ou formulaire XFA-only non pris en charge) : le composant reste simplement inactif. Vérifiez Active après l’affectation et lisez LastLoadReport, dont le Status vaut plsFailed et dont l’ErrorMessage décrit l’échec

Remarks

Example

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);

See Also

FileName, Password, LoadDocument, PageCount, LoadLibrary, CreateDocument