PDFium Component Docs

Enabled eigenschap

Component: TPdfView  ·  Unit: PDFium
Bepaalt of de PDF-viewer gebruikersinvoer van muis en toetsenbord accepteert

Syntax

property Enabled: Boolean; // published, inherited from TControl

Description

Wanneer Enabled True is, reageert de viewer op muisklikken, slepen, het muiswiel en toetsenbordnavigatie. Instellen op False blokkeert alle gebruikersinvoer — muisklikken wijzigen de selectie of scrollpositie niet meer, sneltoetsen verplaatsen geen pagina's meer, en formulierveld-widgets ontvangen geen gebeurtenissen meer — terwijl de pagina nog normaal wordt gerenderd.

Dit is de canonieke "alleen-lezen voorbeeld"-modus: het document blijft zichtbaar zodat de gebruiker de inhoud kan zien, maar kan niet per ongeluk er voorbij scrollen, formuliervelden wijzigen of een tekstselectie oppakken. Gebruik het terwijl een langlopende bewerking draait (opslaan, afdrukken, exporteren) om de UI voorspelbaar te houden, en schakel de viewer weer in wanneer het werk klaar is.

De uitgeschakelde toestand propageert ook vanuit de bovenliggende container — als het bovenliggende paneel wordt uitgeschakeld, wordt de viewer voor invoerdoeleinden als uitgeschakeld behandeld, zelfs als zijn eigen Enabled True is. De visuele weergave van uitgeschakelde inhoud hangt af van het hostthema; sommige VCL-thema's dimmen het besturingselement terwijl andere de weergave ongewijzigd laten.

Remarks

Example

// Disable the viewer while a long export is in progress
procedure TForm1.btnExportClick(Sender: TObject);
begin
  PdfView1.Enabled := False;
  try
    ExportAllPagesToImages(PdfView1.Pdf, 'C:\out\');
  finally
    PdfView1.Enabled := True;
    PdfView1.SetFocus;
  end;
end;

See Also

Visible, AllowUserPageChange, AllowUserTextSelection, TabStop