PDFiumPas 文件

Enabled 屬性

此 API 條目保留識別符號、簽名、程式碼塊和 PDF 術語的原始形式。
元件: TPdfView  ·  單元: PDFium
控制 PDF 檢視器是否接受來自滑鼠與鍵盤的使用者輸入

語法

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

說明

EnabledTrue 時,檢視器會回應滑鼠點擊、拖曳、滑鼠滾輪與鍵盤導覽。把它設為 False 會封鎖所有使用者輸入,滑鼠點擊不再改變選取或捲動位置,鍵盤快捷鍵不再移動頁面,表單欄位元件也不再接收事件,而頁面仍會正常渲染

這就是標準的唯讀預覽模式:文件仍會顯示,使用者看得到內容,但不會不小心捲過頭、修改表單欄位或選取文字。當長時間作業正在進行時(儲存、列印、匯出)可先用這個模式維持 UI 可預測,等工作完成後再重新啟用檢視器

停用狀態也會從父元件往下傳遞,因此如果父面板被停用,即使檢視器自己的 EnabledTrue,它在輸入層面仍會被視為停用。停用內容的視覺外觀取決於主題;有些 VCL 主題會把控制項調暗,有些則不改變外觀

備註

範例

// 在長時間匯出進行時停用檢視器
procedure TForm1.btnExportClick(Sender: TObject);
begin
  PdfView1.Enabled := False;
  try
    ExportAllPagesToImages(PdfView1.Pdf, 'C:\out\');
  finally
    PdfView1.Enabled := True;
    PdfView1.SetFocus;
  end;
end;

另請參閱

Visible, AllowUserPageChange, AllowUserTextSelection, TabStop