UIElement3D.PreviewMouseLeftButtonDown イベント

  • リファレンス

定義

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

この要素の上にマウス ポインターがある状態でマウスの左ボタンが押されたときに発生します。

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

イベントの種類

MouseButtonEventHandler

実装

PreviewMouseLeftButtonDown

注釈

この ルーティング イベントの概要 は、要素ツリーを介したトンネリング ルートに従っているようですが、実際には、各 UIElement3Dによって要素ツリーに沿って発生および再評価される直接ルーティング イベントです。

このイベントは、基になる Mouse.PreviewMouseDown イベントのマウス ボタンの詳細を報告するいくつかの関連イベントの 1 つです。これは、イベント ルートに沿って各要素によって処理される添付イベントです。

このイベントのイベント データは、基になる Mouse.PreviewMouseDown イベントのイベント データを公開します。 そのイベントがイベント ルートに沿って処理済みとしてマークされている場合は、マウス ボタン固有のイベントが引き続き発生します。ただし、マウス ボタン固有のイベントのハンドラーは、 を明示的に呼び出 AddHandlerすことによって追加する必要があります。イベントのリスナーにするには、既に処理済みとしてマークされているイベントを処理するオプションを指定します。 処理済みとしてマーク PreviewMouseLeftButtonDown すると、基本的には、ルートに沿ったそれ以降のすべてのリスナーと、関連するすべてのイベントに対して処理済みとしてマーク Mouse.PreviewMouseDown されます。 これには、 などの PreviewMouseDoubleClickクラス ハンドラーによって生成されたイベントが含まれる場合があります。

概念的には、このイベント (および の UIElement3D他のマウス ボタン イベント) は、(クラスによって Mouse 提供されるサービス定義を使用して) マウスの "サービス" であると考えてください。 このイベントにより、元のマウス イベントのマウス ボタンの状態 (左右、上下) をイベント データにチェックする必要がなくなったという利便性が向上します。 標準以外のボタンの状態を確認するなど、より高度なシナリオでは、 ではなく、 クラスUIElement3Dで Mouse API を使用する必要がある場合があります。

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

ルーティングされたイベント情報
識別子フィールド PreviewMouseLeftButtonDownEvent
ルーティング戦略 直接
代理人 MouseButtonEventHandler
  • 派生クラスでこのイベントのクラス処理を実装するには、 をオーバーライド OnPreviewMouseLeftButtonDown します。

適用対象

こちらもご覧ください