PDFiumPas 文件

OnMouseDown event

此 API 條目保留識別符號、簽名、程式碼塊和 PDF 術語的原始形式。
元件: TPdfView  ·  單元: PDFium
當使用者在檢視器上按下滑鼠按鍵時觸發

語法

property OnMouseDown: TMouseEvent;

說明

當使用者在檢視器上按下任一滑鼠按鍵時,就會觸發這個事件。Sender 參數指向觸發事件的 TPdfView 執行個體,因此同一個處理常式可透過檢查 Sender 服務多個檢視器。常見用途包括開始自訂選取框、啟動平移動作,或記錄座標以支援「跳到此註解」之類的功能。由於處理常式在 VCL 主執行緒上執行,因此你可以直接更新表單控制項並呼叫其他 VCL API,但仍應快速返回,避免阻塞 PDFium 轉譯與表單處理

備註

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

範例

procedure TForm1.PdfViewOnMouseDown(Sender: TObject; Button: TMouseButton; Shift: TShiftState; X, Y: Integer);
begin
  // begin a custom selection box, start panning, or capture coordinates for a "go to this annotation" feature
  Caption := Format('OnMouseDown on page %d', [PdfView1.PageNumber]);
end;

另請參閱

OnClick, OnPageChange, PageNumber