OnKeyUp 이벤트

OnKeyUp는 TPdfView에 published된 표준 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 등입니다. 연속적인 상호작용(패닝, 마퀴 선택)은 OnKeyDown에서 구동하는 편이 낫습니다. 운영체제는 KeyDown을 자동 반복하지만 물리적인 놓기마다 KeyUp은 한 번만 내보내기 때문입니다

• 문자를 만들어 내는 키에 대해서는 운영체제가 KeyDown, KeyPress, KeyUp 순으로 보냅니다 키를 놓을 때 정확히 한 번 발생한다고 보장되는 이벤트는 OnKeyUp뿐입니다
• 수정자만 놓는 경우(Ctrl, Shift, Alt)에도 OnKeyUp는 발생합니다 — 무시하고 싶다면 Key in [VK_CONTROL, VK_SHIFT, VK_MENU]을 검사하세요
• 임베드된 AcroForm 위젯이 키를 소비하면(편집 가능한 텍스트 필드가 포커스를 가진 경우) OnKeyUp는 발생하지 않을 수 있습니다 — 폼 레이어가 메시지를 VCL 핸들러에 도달하기 전에 가로챕니다