PDFium Component Docs

Enabled Właściwość

Component: TPdfView  ·  Unit: PDFium
Określa, czy przeglądarka PDF przyjmuje dane wejściowe użytkownika z myszy i klawiatury

Syntax

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

Description

Gdy Enabled ma wartość True, przeglądarka odpowiada na kliknięcia myszy, przeciągania, kółko myszy i nawigację klawiaturą. Ustawienie na False blokuje wszystkie dane wejściowe użytkownika — kliknięcia myszy nie zmieniają już zaznaczenia ani położenia przewijania, skróty klawiszowe nie przenoszą stron, a widgety pól formularzy przestają otrzymywać zdarzenia — podczas gdy strona jest nadal renderowana normalnie

To kanoniczny tryb "podglądu tylko do odczytu": dokument pozostaje widoczny, więc użytkownik może zobaczyć treść, ale nie może przypadkiem przewinąć poza niego, zmienić pól formularza ani pobrać zaznaczenia tekstu. Używaj go podczas długiej operacji (zapisywanie, drukowanie, eksportowanie), aby utrzymać przewidywalny interfejs, a następnie ponownie włącz przeglądarkę po zakończeniu pracy

Stan wyłączenia propaguje się także z rodzica — jeśli panel nadrzędny zostanie wyłączony, przeglądarka jest traktowana jako wyłączona do celów wejścia, nawet jeśli jej własne Enabled ma wartość True. Wygląd wyłączonej treści zależy od motywu hosta; niektóre motywy VCL przyciemniają kontrolkę, a inne pozostawiają wygląd niezmieniony

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