ContentElement.PreviewKeyDown イベント

定義

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

public:
 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 添付イベントのエイリアスを作成し、ContentElement が基本要素として継承されている場合に、PreviewKeyDown がクラスメンバーリストの一部になるようにします。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 ContentElement 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.

適用対象

こちらもご覧ください