PDFiumPas 文件

Visible 屬性

此 API 條目保留識別符號、簽名、程式碼塊和 PDF 術語的原始形式。
元件: TPdfView  ·  單元: PDFium
顯示或隱藏 PDF 檢視器

語法

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

說明

Visible := False 會把檢視器從畫面上隱藏,但不會將其銷毀;底層的 PDFium 文件、目前頁面、縮放倍率與選取狀態都會保留。當屬性改回 True 時,快取狀態會立即重新顯示,並自動排入重新繪製

隱藏檢視器是在不同文件檢視之間切換的慣用方式,例如只顯示縮圖模式與完整閱讀器,而不必重新建立元件。由於隱藏期間 PDFium 頁面控制代碼仍保持開啟,使用者可以快速切換檢視而沒有重新載入延遲

可見性也會透過容器控制元件傳遞:如果父面板不可見,檢視器就會不可見,不受自身設定影響。架構仍會在表單上觸發 OnShow / OnHide 通知,讓應用程式程式碼能相應同步工具列

備註

範例

// Toggle between thumbnail mode and full reader on a button click
procedure TForm1.btnToggleViewClick(Sender: TObject);
begin
  ThumbnailGrid.Visible := PdfView1.Visible;
  PdfView1.Visible := not PdfView1.Visible;
  if PdfView1.Visible then
    PdfView1.SetFocus;
end;

另請參閱

Enabled, Active, AsyncRendering, Align