PDFium Component Docs

OnClick event

이 API 항목은 식별자, 시그니처, 코드 블록, PDF 용어를 원래 형태로 유지합니다.
컴포넌트: TPdfView  ·  유닛: PDFium
사용자가 viewer 안에서 왼쪽 mouse button을 클릭할 때 발생합니다

구문

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

설명

OnClick는 사용자가 cursor를 drag로 인식될 만큼 움직이지 않은 상태에서 왼쪽 mouse button을 눌렀다 놓으면 표준 OnMouseDown / OnMouseUp sequence 뒤에 발생합니다. Sender parameter는 TPdfView instance 자체이며 cursor position은 전달되지 않지만 Mouse.CursorPos에서 얻어 ScreenToClient로 변환할 수 있습니다

annotation, web link, form field에 대한 viewer의 내부 click 처리는 이 event보다 앞서 실행됩니다 — click이 이동 가능한 link를 건드렸다면 page jump 또는 URI launch는 이미 완료된 상태입니다. 따라서 OnClick는 tool-tip overlay를 닫거나 thumbnail panel을 숨기거나 analytics event를 기록하거나 focus mode를 전환하는 등 application-level reaction에 가장 유용합니다

더 세밀한 position이 필요하면 대신 OnMouseDown 또는 OnMouseUp을 연결하세요. 특정 PDF object(annotation, link, form field) 클릭을 감지하려면 전용 event인 OnAnnotationLinkClickOnWebLinkClick를 사용하거나 OnMouseDown에서 HasFormFieldAt를 호출하세요

비고

예제

// 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;

참고 항목

OnDblClick, OnMouseUp, OnAnnotationLinkClick, OnWebLinkClick