PDFium Delphi Component Docs

OnClick event

Component: TPdfView  ·  Unit: PDFium
يحدث عندما ينقر المستخدم داخل العارض بالزر الأيسر للفأرة

Syntax

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

Description

يطلق OnClick بعد تسلسل OnMouseDown / OnMouseUp القياسي كلما ضغط المستخدم زر الفأرة الأيسر وحرره دون تحريك المؤشر مسافة كافية لتُحسب سحبًا. ومعامل Sender هو نسخة TPdfView نفسها؛ ولا يُمرر موضع المؤشر، لكن يمكن جلبه من Mouse.CursorPos وترجمته عبر ScreenToClient

يعمل معالجة النقر الداخلي للعارض للتعليقات وروابط الويب وحقول النماذج قبل هذا الحدث — فإذا أصابت النقرة رابطًا قابلًا للتنقل كانت قفزة الصفحة أو تشغيل الـ URI قد حدثت بالفعل. لذا يكون OnClick أنفع ما يكون في ردود الفعل على مستوى التطبيق: إغلاق طبقة تلميح أداة، أو إخفاء لوحة مصغرات، أو تسجيل حدث تحليلات، أو قلب وضع التركيز

إذا احتجت موضعًا دقيقًا، فاربط OnMouseDown أو OnMouseUp بدلًا منه. ولرصد النقر على كائنات PDF بعينها (تعليقات، روابط، حقول نماذج)، استخدم الحدثين المخصصين OnAnnotationLinkClick و OnWebLinkClick، أو استدعِ HasFormFieldAt من 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