UIElement.PreviewKeyDown UIElement.PreviewKeyDown UIElement.PreviewKeyDown UIElement.PreviewKeyDown Event


この要素にフォーカスがある状態でキーが押されたときに発生します。Occurs when a key is pressed while focus is on this element.

 virtual event System::Windows::Input::KeyEventHandler ^ PreviewKeyDown;
public event System.Windows.Input.KeyEventHandler PreviewKeyDown;
member this.PreviewKeyDown : System.Windows.Input.KeyEventHandler 
Public Custom Event PreviewKeyDown As KeyEventHandler 



キー処理は、コマンド処理やテキスト構成などの他のプラットフォーム機能とやり取りします。Key handling interacts with other platform features such as commanding and text composition. KeyDownイベントは、特定のコントロールで期待どおりに動作しない可能性がある下位レベルのテキスト入力イベントです。The KeyDown event is a lower-level text input event that might not behave as expected on certain controls. これは、一部のコントロールには、テキスト入力処理と関連イベントの上位レベルのバージョンを提供するコントロールの複合またはクラス処理があるためです。This is because some controls have control compositing or class handling that provides a higher-level version of text input handling and related events.

このイベントは、このクラスのKeyboard.PreviewKeyDown添付イベントのエイリアスを作成しますPreviewKeyDown 。これにより、が基本要素UIElementとして継承されている場合、はクラスメンバーリストの一部になります。This event creates an alias for the Keyboard.PreviewKeyDown attached event for this class, so that PreviewKeyDown is part of the class members list when UIElement is inherited as a base element. イベントにPreviewKeyDownアタッチされているイベントハンドラーは、基にKeyboard.PreviewKeyDownなる添付イベントにアタッチされ、同じイベントデータインスタンスを受け取ります。Event handlers that are attached to the PreviewKeyDown event are attached to the underlying Keyboard.PreviewKeyDown attached event and receive the same event data instance.

ルーティングされたイベント情報Routed Event Information

識別子フィールドIdentifier field PreviewKeyDownEvent
ルーティング方法Routing strategy トンネリングTunneling
DelegateDelegate KeyEventHandler
  • 対応するバブルイベントはKeyDownです。The corresponding bubbling event is KeyDown.

  • OnPreviewKeyDownオーバーライドして、派生クラスでこのイベントのクラス処理を実装します。Override OnPreviewKeyDown to implement class handling for this event in derived classes.