UIElement.PreviewMouseLeftButtonDown 事件
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
滑鼠指標在此元素上方且按下滑鼠左按鈕時發生。
public:
virtual event System::Windows::Input::MouseButtonEventHandler ^ PreviewMouseLeftButtonDown;C#
public event System.Windows.Input.MouseButtonEventHandler PreviewMouseLeftButtonDown;member this.PreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventHandler Public Custom Event PreviewMouseLeftButtonDown As MouseButtonEventHandler 雖然這個 路由事件 似乎會透過元素樹狀結構遵循通道路由，但它實際上是由每個 UIElement 沿著元素樹狀結構引發並重新建立的直接路由事件。
這個事件是數個相關事件之一，會報告基礎 Mouse.PreviewMouseDown 事件的滑鼠按鍵特定專案，這是由事件路由的每個元素所處理的附加事件。
此事件的事件資料會公開基礎 Mouse.PreviewMouseDown 事件的事件資料。 如果該事件標示為沿著事件路由處理，則仍會引發滑鼠按鍵特定事件;不過，必須藉由明確呼叫 AddHandler 來新增滑鼠按鍵特定事件的處理常式，並可選擇處理已標示為已處理的事件，以便接聽事件。 如果您標示 PreviewMouseLeftButtonDown 已處理，基本上 Mouse.PreviewMouseDown 會標示路由上所有進一步接聽程式以及所有相關事件的處理。 這可能包括類別處理常式產生的事件，例如 PreviewMouseDoubleClick 。
在概念上，請將此事件 (和其他滑鼠按鍵事件 UIElement) 為滑鼠「服務」 (，以及類別) 所提供的 Mouse 服務定義。 事件會新增不需要檢查滑鼠按鍵狀態的便利性， (事件資料中原始滑鼠事件的上下) 。 如需更進階的案例，例如檢查非標準按鈕的狀態，您可能需要在 類別上使用 Mouse API，而不是 上的 UIElement API。
| 識別碼欄位 | PreviewMouseLeftButtonDownEvent |
| 路由策略 | 直接 |
| 代理人 | MouseButtonEventHandler |
- 覆寫 OnPreviewMouseLeftButtonDown 以在衍生類別中實作這個事件的類別處理。
| 產品 | 版本 |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
