PDFium Delphi Component Docs

OnClick event

Komponente: TPdfView  ·  Unit: PDFium
Wird ausgelöst, wenn der Benutzer im Viewer mit der linken Maustaste klickt

Syntax

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

Description

OnClick feuert nach der üblichen OnMouseDown- / OnMouseUp-Sequenz, wann immer der Nutzer die linke Maustaste drückt und loslässt, ohne den Cursor so weit zu bewegen, dass es als Ziehen zählt. Der Sender-Parameter ist die TPdfView-Instanz selbst; die Cursorposition wird nicht übergeben, lässt sich aber aus Mouse.CursorPos holen und mit ScreenToClient umrechnen

Die interne Klick-Behandlung des Viewers für Annotationen, Web-Links und Formularfelder läuft vor diesem Ereignis — traf der Klick einen navigierbaren Link, sind Seitensprung oder URI-Aufruf bereits passiert. OnClick ist daher am nützlichsten für Reaktionen auf Anwendungsebene: einen Tooltip-Overlay schließen, ein Thumbnail-Panel verstecken, ein Analytics-Event aufzeichnen oder einen Fokusmodus umschalten

Wer eine feine Position braucht, hängt stattdessen OnMouseDown oder OnMouseUp ein. Klicks auf konkrete PDF-Objekte (Annotationen, Links, Formularfelder) erkennt man über die dedizierten Ereignisse OnAnnotationLinkClick und OnWebLinkClick oder über einen HasFormFieldAt-Aufruf aus OnMouseDown

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