PDFium Delphi Component Docs

Active Свойство

Компонент: TPdf  ·  Модуль: PDFium
Открывает или закрывает выбранный PDF-документ

Syntax

property Active: Boolean; // default False

Description

Установка Active в True открывает и загружает PDF-документ, заданный в FileName, используя Password, если документ зашифрован. При значении False документ закрывается, а все связанные ресурсы PDFium (страницы, шрифты, дескрипторы форм, текстовые страницы) освобождаются

Вместо переключения этого свойства можно вызвать LoadDocument напрямую; при неудаче он возбуждает EPdfError. FileName и Password можно присваивать только пока компонент неактивен, поэтому переключение документов в одном экземпляре TPdf выглядит так: установить Active в False, задать новый путь и снова установить Active в True

Установка Active в True не возбуждает исключение, когда файл не открывается (неверный путь, плохой пароль, поврежденный PDF или неподдерживаемая форма только с XFA): компонент просто остаётся неактивным. Проверьте Active после присваивания и прочитайте LastLoadReport, у которого Status равен plsFailed, а ErrorMessage описывает сбой

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