property Enabled: Boolean; // published, inherited from TControl
Gdy Enabled ma wartość True, przeglądarka reaguje na kliknięcia myszy, przeciąganie, kółko myszy i nawigację z klawiatury. Ustawienie na False blokuje cały input użytkownika — kliknięcia myszy nie zmieniają już zaznaczenia ani pozycji przewijania, skróty klawiaturowe nie przesuwają już stron, a kontrolki pól formularza przestają odbierać zdarzenia — przy czym strona nadal renderuje się normalnie
To jest kanoniczny tryb „podgląd tylko do odczytu”: dokument pozostaje widoczny, więc użytkownik widzi treść, ale nie może przypadkowo przewinąć jej dalej, zmienić pól formularza ani utworzyć zaznaczenia tekstu. Użyj go podczas trwania długiej operacji (zapisywania, drukowania, eksportu), aby utrzymać przewidywalność interfejsu, a potem ponownie włącz przeglądarkę po zakończeniu pracy
Stan wyłączenia dziedziczy się także z rodzica — jeśli panel nadrzędny zostanie wyłączony, przeglądarka jest traktowana jako wyłączona dla wejścia, nawet jeśli jej własne Enabled ma wartość True. Wygląd wyłączonej zawartości zależy od motywu hosta; niektóre motywy VCL przygaszają kontrolkę, a inne pozostawiają wygląd bez zmian
TrueAsyncRendering — buforowane bitmapy stron nadal są odświeżane, blokowane jest tylko wejście użytkownikaAllowUserPageChange i AllowUserTextSelection zamiast wyłączać całą kontrolkę
// 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;