PDFium Delphi Component Docs

OnClick event

コンポーネント: TPdfView  ·  ユニット: PDFium
ユーザーが viewer 内を左 mouse button でクリックしたときに発生します

Syntax

property OnClick: TNotifyEvent; // published, inherited from TControl

Description

OnClick は、標準の OnMouseDown / OnMouseUp シーケンスのあと、ユーザーがドラッグと判定されるほどカーソルを動かさずに左ボタンを押して離すたびに発生します。Sender パラメーターは TPdfView インスタンス自身で、カーソル位置は渡されませんが、Mouse.CursorPos から取得して ScreenToClient で変換できます

注釈・Web リンク・フォームフィールドに対するビューアー内部のクリック処理は、このイベントの前に走ります。クリックがナビゲーション可能なリンクに当たっていれば、ページジャンプや URI 起動はすでに済んでいます。したがって OnClick が最も活きるのはアプリケーションレベルの反応です。ツールチップのオーバーレイを閉じる、サムネイルパネルを隠す、分析イベントを記録する、フォーカスモードを切り替える、といった具合です

位置情報まで要るなら、代わりに OnMouseDown か OnMouseUp をフックしてください。特定の PDF オブジェクト(注釈、リンク、フォームフィールド)へのクリック検出には、専用イベントの OnAnnotationLinkClick と OnWebLinkClick を使うか、OnMouseDown から HasFormFieldAt を呼びます

Remarks

Example

// Dismiss an overlay panel whenever the user clicks the document
procedure TForm1.PdfView1Click(Sender: TObject);
begin
  if SearchPanel.Visible then
    SearchPanel.Hide;
  StatusBar1.SimpleText := Format('Clicked — page %d of %d',
    [PdfView1.PageNumber, PdfView1.Pdf.PageCount]);
end;

See Also

OnDblClick, OnMouseUp, OnAnnotationLinkClick, OnWebLinkClick