PDFiumPas 文件

OnPageChange event

此 API 條目保留識別符號、簽名、程式碼塊和 PDF 術語的原始形式。
元件: TPdfView  ·  單元: PDFium
當目前頁面因任何原因發生變化時觸發

語法

property OnPageChange: TNotifyEvent;

說明

只要目前頁面因任何原因改變,就會觸發這個事件。Sender 參數指向觸發事件的 TPdfView 執行個體,因此同一個處理常式可透過檢查 Sender 服務多個檢視器。常見用途包括更新外部的「Page X of Y」標籤,或同步並排顯示的縮圖面板。由於處理常式在 VCL 主執行緒上執行,因此可直接更新表單控制項並呼叫其他 VCL API,但仍應快速返回,避免拖慢 PDFium 轉譯與表單互動

備註

若希望此控制項參與 Tab 鍵焦點巡覽並收到鍵盤事件,請將 TabStop 設為 True。當你在設計階段指派這個事件時,IDE 會在表單上產生存根程序;也可在執行階段透過 PdfView1.OnPageChange := MyHandler 指派。若你的 UI 同時也會調整游標或插入點,建議搭配 TPdfView 上對應的 Set Cursor / Set Caret 呼叫,讓視覺回饋保持同步

範例

procedure TForm1.PdfViewOnPageChange(Sender: TObject);
begin
  // update an external "Page X of Y" label or sync a side-by-side thumbnail panel
  Caption := Format('OnPageChange on page %d', [PdfView1.PageNumber]);
end;

另請參閱

OnClick, OnMouseDown, PageNumber