UIElement3D.MouseLeftButtonDown 事件

  • 參考

定義

命名空間:
System.Windows
組件:
PresentationCore.dll

滑鼠指標在此元素上方且按下滑鼠左按鈕時發生。

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

事件類型

MouseButtonEventHandler

實作

MouseLeftButtonDown

備註

雖然此 路由事件概觀 似乎遵循元素樹狀結構中的反升路由，但它實際上是由每個 UIElement3D 在元素樹狀結構中引發和重新調整的直接路由事件。

這個事件是數個相關事件之一，會報告基礎 Mouse.MouseDown 事件的滑鼠按鍵特定專案，這是由事件路由的每個元素所處理的附加事件。

此事件的事件資料會公開基礎 Mouse.MouseDown 事件的事件資料。 如果該事件標示為沿著事件路由處理，則仍會引發滑鼠按鍵特定事件;不過，必須藉由明確呼叫 AddHandler 來新增滑鼠按鍵特定事件的處理常式，並可選擇處理已標示為已處理的事件，以便接聽事件。 如果您標示 MouseLeftButtonDown 已處理，基本上 Mouse.MouseDown 會標示路由上所有進一步接聽程式以及所有相關事件的處理。 這可能包括類別處理常式產生的事件，例如 MouseDoubleClick 。

在概念上，請將此事件 (和其他滑鼠按鍵事件 UIElement3D) 為滑鼠「服務」 (，以及類別) 所提供的 Mouse 服務定義。 事件會新增不需要檢查滑鼠按鍵狀態的便利性， (事件資料中原始滑鼠事件的上下) 。 如需更進階的案例，例如檢查非標準按鈕的狀態，您可能需要在 類別上使用 Mouse API，而不是 上的 UIElement3D API。

重要

類別處理通常會將基礎 Mouse 類別事件標示為已處理。 一旦事件標示為已處理，附加至該元素的其他實例處理常式通常不會引發。 附加至 UI 樹狀結構根目錄之元素的任何其他類別或實例處理常式，通常也不會引發。

您可以使用下列其中一個解決方案來解決上述 [重要] 中所述的問題，但仍會在具有類別處理的衍生類別上接收 MouseLeftButtonDown 滑鼠左鍵向下事件的事件：

  • 附加 事件的處理常式 PreviewMouseDown ，不會標示為控制項所處理。 請注意，因為這是預覽事件，所以路由會從根目錄開始，並向下通道至控制項。

  • 藉由呼叫 AddHandler 並選擇簽章選項，在控制項上註冊處理常式，讓處理常式接聽事件，即使它們已標示為在路由事件資料中處理也一樣。

MouseLeftButtonDown.NET Framework 3.5 版引進。 如需詳細資訊，請參閱版本和相依性。

路由事件資訊
識別碼欄位 MouseLeftButtonDownEvent
路由策略 直接
代理人 MouseButtonEventHandler

適用於

另請參閱