PDFium Delphi Component Docs

Active властивість

Component: TPdfView  ·  Unit: PDFium
Описує властивість TPdfView.Active у PDFium Delphi Component і пояснює, коли використовувати цей член API

Syntax

property Active: Boolean; // default False

Description

Призначення Active значення True вказує переглядачу завантажити документ, на який посилається пов'язаний компонент Pdf, відкрити сторінку, визначену PageNumber, і викликати перемалювання. Призначення False закриває сторінку, звільняє кешований дескриптор текстової сторінки, відкидає сеанс пошуку та очищає видиму область

Active є головним перемикачем переглядача. Пов'язані з документом властивості, як-от PageCount, PageWidth, PageLabel, та індексовані доступники (Character, Bitmap, WebLink тощо) повертають змістовні значення, лише коли Active дорівнює True і пов'язаний екземпляр Pdf має завантажений документ

Якщо Pdf дорівнює nil, переглядач створює та володіє внутрішнім екземпляром TPdf під час першого призначення Active значення True, тож мінімальна програма може просто викликати PdfView1.Pdf.FileName := ...; PdfView1.Active := True; після вказування файлу

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