PDFium Delphi Component Docs

Active 속성

컴포넌트: TPdf  ·  유닛: PDFium
선택한 PDF 문서를 열거나 닫습니다

Syntax

property Active: Boolean; // default False

Description

Active를 True로 바꾸면 FileName이 가리키는 PDF 문서를 열고 로드하며, 암호화된 문서라면 Password를 사용합니다. False로 바꾸면 문서를 닫고 관련된 PDFium 자원(페이지, 폰트, 폼 핸들, 텍스트 페이지)을 모두 해제합니다

이 프로퍼티를 대신해 LoadDocument를 직접 호출해도 되며, 실패하면 EPdfError가 발생합니다. FileName과 Password는 컴포넌트가 비활성일 때만 대입할 수 있으므로, TPdf 인스턴스 하나에서 문서를 갈아끼우려면 Active를 False로 설정하고 새 경로를 대입한 뒤 다시 Active를 True로 설정합니다

파일을 열 수 없으면(잘못된 경로, 틀린 암호, 깨진 PDF, 지원하지 않는 XFA 전용 폼 등) Active를 True로 설정해도 예외가 발생하지 않고 컴포넌트는 비활성으로 남습니다. 대입 뒤 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