PDFium Component Docs

Enabled Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.
Komponente: TPdfView  ·  Unit: PDFium
Steuert, ob der PDF-Viewer Benutzereingaben von Maus und Tastatur annimmt

Syntax

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

Beschreibung

Wenn Enabled True ist, reagiert der Viewer auf Mausklicks, Ziehbewegungen, das Mausrad und die Tastaturnavigation. Wenn Sie es auf False setzen, werden alle Benutzereingaben blockiert — Mausklicks ändern die Auswahl oder Scrollposition nicht mehr, Tastenkürzel wechseln keine Seiten mehr, und Formularfeld-Widgets erhalten keine Ereignisse mehr — während die Seite weiterhin normal gerendert wird

Das ist der typische Modus für die schreibgeschützte Vorschau: Das Dokument bleibt sichtbar, sodass der Benutzer den Inhalt sehen kann, aber er kann nicht versehentlich daran vorbeiscrollen, Formularfelder ändern oder eine Textauswahl erfassen. Verwenden Sie ihn, während eine längere Operation läuft (Speichern, Drucken, Exportieren), um die UI berechenbar zu halten, und aktivieren Sie den Viewer wieder, wenn die Arbeit abgeschlossen ist

Der deaktivierte Zustand wird auch vom Parent vererbt — wenn das übergeordnete Panel deaktiviert wird, gilt der Viewer für Eingaben als deaktiviert, auch wenn sein eigenes Enabled True ist. Das Aussehen deaktivierter Inhalte hängt vom Host-Theme ab; manche VCL-Themes dimmen das Steuerelement, andere lassen das Erscheinungsbild unverändert

Hinweise

Beispiel

// Den Viewer deaktivieren, während ein längerer Export läuft
procedure TForm1.btnExportClick(Sender: TObject);
begin
  PdfView1.Enabled := False;
  try
    ExportAllPagesToImages(PdfView1.Pdf, 'C:\out\');
  finally
    PdfView1.Enabled := True;
    PdfView1.SetFocus;
  end;
end;

Siehe auch

Visible, AllowUserPageChange, AllowUserTextSelection, TabStop