PDFium Component Docs

OnKeyUp 이벤트

Component: TPdfView  ·  Unit: PDFium
뷰어 컨트롤에 포커스가 있는 동안 키를 떼면 발생합니다.

구문

property OnKeyUp: TKeyEvent;

설명

OnKeyUp은 TPdfView에 게시된 표준 VCL 키보드 이벤트입니다. 이 핸들러는 컨트롤에 포커스가 있는 동안 운영 체제에서 WM_KEYUP / WM_SYSKEYUP 메시지를 보고한 후에 실행됩니다. 이벤트 서명은 procedure(Sender: TObject; var Key: Word; Shift: TShiftState)입니다 — Key는 가상 키 코드(VK_ESCAPE, VK_NEXT, VK_PRIOR 등)이고 Shift는 릴리스 순간의 한정자 상태를 보고합니다.

OnKeyUp은 TPdfView에 키보드 포커스가 있는 한 방향 키 및 기능 키와 같은 문자가 아닌 키를 포함하여 모든 키에 대해 실행됩니다. 이벤트를 소비하여 더 이상 전파되지 않도록 하려면 핸들러 내부에서 Key를 0으로 설정하세요(예: 양식 필드를 편집할 때 Tab이 포커스를 순환하는 것을 차단).

OnKeyUp을 사용하여 누르고 있는 것이 아니라 릴리스할 때 실행되어야 하는 뷰어 바로 가기를 구현하세요 — 탐색을 위한 Page Down / Page Up, 다음 찾기를 위한 F3, 선택을 취소하기 위한 Escape. 운영 체제가 KeyDown을 자동 반복하지만 물리적 릴리스당 하나의 KeyUp만 내보내기 때문에 지속적인 상호 작용(이동, 마키 선택)은 OnKeyDown에서 구동하는 것이 더 낫습니다.

비고

예제

procedure TForm1.PdfView1KeyUp(Sender: TObject; var Key: Word; Shift: TShiftState);
begin
  case Key of
    VK_NEXT:  PdfView1.PageNumber := PdfView1.PageNumber + 1;
    VK_PRIOR: PdfView1.PageNumber := PdfView1.PageNumber - 1;
    VK_HOME:  PdfView1.PageNumber := 1;
    VK_END:  PdfView1.PageNumber := Pdf1.PageCount;
    VK_ESCAPE: PdfView1.ClearHighlight;
  end;
end;

참고 항목

OnKeyDown, OnKeyPress, PageNumber, ClearHighlight