UIElement3D.OnKeyDown(KeyEventArgs) メソッド

  • リファレンス

定義

名前空間:
System.Windows
アセンブリ:
PresentationCore.dll

アタッチされた未処理の KeyDown イベントが、そのルート上で、このクラスから派生した要素に到達すると呼び出されます。 このイベントに対するクラス処理を追加するには、このメソッドを実装します。

protected public:
 virtual void OnKeyDown(System::Windows::Input::KeyEventArgs ^ e);
protected internal virtual void OnKeyDown (System.Windows.Input.KeyEventArgs e);
abstract member OnKeyDown : System.Windows.Input.KeyEventArgs -> unit
override this.OnKeyDown : System.Windows.Input.KeyEventArgs -> unit
Protected Friend Overridable Sub OnKeyDown (e As KeyEventArgs)

パラメーター

e
KeyEventArgs

イベント データを格納している KeyEventArgs。

注釈

キーストロークは、専用の入力マネージャーによって処理されます。 キーストロークに依存するその他のプログラミング機能 (入力バインディングやコマンド バインドなど) は、一般的なキーストロークとして公開される前にキーストロークを処理する場合があります。 これらの入力システム機能によってイベントが処理済みとしてマークされた場合、 OnKeyDown は呼び出されません。

このメソッドには、既定の実装はありません。 継承の中間クラスはこのメソッドを実装する可能性があるため、実装で基本実装を呼び出することをお勧めします。

このメソッドの目的は、共通言語ランタイム (CLR) イベント パターン On* メソッドに似ています。このメソッドは、インスタンス ハンドラーではなくクラス ハンドラーを確立することによって、派生クラスからの一致するイベントを処理する手段を提供します。 この場合、一致するイベントはルーティング イベントです。 ルーティング イベントは子要素によって発生する可能性があるため、On* メソッドの実装パターンはルーティング イベントに対して異なります。これは、ハンドラーを呼び出す要素とは限りません。 そのため、実装ではイベント データのソース プロパティを調べる必要があります。 ほとんどの場合、イベントを再評価しようとしないでください。

このメソッドをオーバーライドするか、 にクラス ハンドラー RegisterClassHandlerを登録することで、 の UIElement3D 派生クラスは、イベントがイベント ルートに沿って受信されたときにプライベート クラス ハンドラー メソッドを呼び出すことができます。 クラス処理が適切なシナリオの 1 つは、イベント データを操作し、ルーティング イベントを処理済みとしてマークすることです。

OnKeyDownは、.NET Framework バージョン 3.5 で導入されています。 詳細については、「.NET Framework のバージョンおよび依存関係」を参照してください。

適用対象

こちらもご覧ください