PDFium Delphi Component Docs

OnKeyUp イベント

コンポーネント: TPdfView  ·  ユニット: PDFium
ビューアコントロールがフォーカスを持っている間にキーが離されたときに発生します。

Syntax

property OnKeyUp: TKeyEvent;

Description

OnKeyUp は TPdfView に published された標準 VCL キーボードイベントです。ハンドラーは、コントロールがフォーカスを持つ間に OS が 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 から駆動する方が向いています。OS は KeyDown を自動リピートしますが、KeyUp は物理的なリリースごとに 1 回しか出ないためです

Remarks

Example

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;

See Also

OnKeyDown, OnKeyPress, PageNumber, ClearHighlight