PDFium Delphi Component Docs

Enabled Eigenschaft

Komponente: TPdfView  ·  Unit: PDFium
Steuert, ob der PDF-Viewer Benutzereingaben von Maus und Tastatur annimmt

Syntax

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

Description

Ist Enabled True, reagiert der Viewer auf Mausklicks, Ziehen, das Mausrad und Tastaturnavigation. Auf False gesetzt blockiert er jede Benutzereingabe — Mausklicks ändern Selektion und Scrollposition nicht mehr, Tastenkürzel blättern nicht mehr, und Formularfeld-Widgets bekommen keine Events mehr — während die Seite weiterhin normal gerendert wird

Das ist der kanonische "Read-only-Vorschau"-Modus: Das Dokument bleibt sichtbar, der Nutzer sieht den Inhalt, kann aber weder versehentlich dran vorbeiscrollen, Formularfelder verändern noch eine Textauswahl anreißen. Nützlich, während eine lange Operation läuft (Speichern, Drucken, Exportieren), um die UI berechenbar zu halten; danach den Viewer wieder freischalten

Der Disabled-Zustand propagiert auch vom Parent — wird das Parent-Panel deaktiviert, gilt der Viewer für Eingaben als disabled, selbst wenn sein eigenes Enabled True ist. Wie deaktivierter Inhalt aussieht, hängt vom Host-Theme ab; manche VCL-Themes dimmen das Control, andere lassen das Aussehen unverändert

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