UIElement3D.OnMouseLeftButtonDown(MouseButtonEventArgs) メソッド

定義

名前空間:

System.Windows

アセンブリ:

PresentationCore.dll

この要素上で未処理の MouseLeftButtonDown ルーティング イベントが発生したときに呼び出されます。 このイベントに対するクラス処理を追加するには、このメソッドを実装します。

protected public:
 virtual void OnMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);

protected internal virtual void OnMouseLeftButtonDown (System.Windows.Input.MouseButtonEventArgs e);

abstract member OnMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit

Protected Friend Overridable Sub OnMouseLeftButtonDown (e As MouseButtonEventArgs)

パラメーター

e

MouseButtonEventArgs

イベント データを格納している MouseButtonEventArgs。 このイベント データは、マウスの左ボタンが押されたことを報告します。

注釈

イベントは MouseLeftButtonDown バブル ルートを移動しているように見えますが、実際には間接的な方法で移動します。 Mouse.MouseDown はバブル ルーティングされる基になるイベントであり、イベント ルートに沿ってそれぞれ UIElement3D 同じ処理を使用してダイレクト ルーティング イベント MouseLeftButtonDownを発生させます。 この要素の目的でイベントを MouseLeftButtonDown 処理済みとしてマークすることはできますが、処理済みの状態はイベント ルートに沿って他の要素に永続化されません。 ただし、イベントを処理済みとしてマークして、一般的なインスタンス ハンドラー (指定 handledEventsTooしなかったハンドラー) が呼び出されないようにすることができます。

の一般的なマウス イベント処理の既定の UIElement3D 実装では、 がリッスン Mouse.MouseDown され、適切なローカル イベントに変換されます。 このロジックをオーバーライドする場合は、派生クラスを作成する必要があります。 派生クラスの静的コンストラクターで、 の代替クラス ハンドラー Mouse.MouseDownを登録します。 をオーバーライドして のマウス処理動作 UIElement3D を OnMouseLeftButtonDown変更することはできません。

または、特定のマウス状態のイベント処理を変更するために、このメソッドをオーバーライドすることもできます。 基本実装を呼び出すかどうかを選択するかどうかは、シナリオによって異なります。 base の呼び出しに失敗すると、 を呼び出 OnMouseLeftButtonDownす先祖クラスのマウス イベントの既定の入力処理が無効になります。 たとえば、基本実装を呼び出さずに、派生クラスから派生 Button して オーバーライド OnMouseLeftButtonDown することができます。ただし、このオーバーライドでは イベントが Click 無効になります。

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