PDFium Delphi Component Docs

Active Propriedade

Componente: TPdfView  ·  Unidade: PDFium
Ativa ou desativa o visualizador, abrindo o documento PDF vinculado e renderizando a página selecionada

Syntax

property Active: Boolean; // default False

Description

Definir Active como True instrui o visualizador a carregar o documento referenciado pelo componente Pdf associado, abrir a página identificada por PageNumber e disparar uma repintura. Defini-lo como False fecha a página, libera o handle de página de texto em cache, descarta a sessão de localização e limpa a área visível

Active é a chave principal do visualizador. Propriedades relacionadas ao documento, como PageCount, PageWidth, PageLabel e os acessadores indexados (Character, Bitmap, WebLink etc), só retornam valores significativos enquanto Active é True e a instância Pdf vinculada tem um documento carregado

Se Pdf for nil, o visualizador cria e possui uma instância interna de TPdf na primeira vez que Active é definido como True, de modo que um programa mínimo pode simplesmente chamar PdfView1.Pdf.FileName := ...; PdfView1.Active := True; depois de apontá-lo para um arquivo

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