ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) Method


當未處理的 PreviewMouseLeftButtonDown 路由事件到達其路由中衍生自此類別的項目時叫用。Invoked when an unhandled PreviewMouseLeftButtonDown routed event reaches an element in its route that is derived from this class. 實作這個方法可為此事件加入類別處理。Implement this method to add class handling for this event.

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


MouseButtonEventArgs MouseButtonEventArgs MouseButtonEventArgs MouseButtonEventArgs

包含事件資料的 MouseButtonEventArgsThe MouseButtonEventArgs that contains the event data. 事件資料會報告滑鼠左鍵已按下。The event data reports that the left mouse button was pressed.


PreviewMouseLeftButtonDown事件看起來是旅遊通道路線, 但實際上是以間接方式移動。The PreviewMouseLeftButtonDown event appears to travel a tunneling route but actually travels in an indirect way. Mouse.PreviewMouseDown是以通道路由傳送的基礎事件, 而每ContentElement個事件路由都會使用相同的處理來引發直接路由事件PreviewMouseLeftButtonDownMouse.PreviewMouseDown is the underlying event that is tunnel routed, and each ContentElement along the event route uses identical handling to raise the direct routed event PreviewMouseLeftButtonDown. 雖然您可以將此PreviewMouseLeftButtonDown專案的事件標示為已處理, 但已處理的狀態並不會沿著事件路由永久保存至其他元素。Although you can mark the PreviewMouseLeftButtonDown event as handled for purposes of this element, the handled state does not perpetuate to other elements along the event route. 不過, 您可能會想要將事件標示為已處理, 以避免叫用一般實例處理常式 (未handledEventsToo指定的)。However, you might want to mark the event as handled in order to prevent general instance handlers (those that did not specify handledEventsToo) from being invoked.

ContentElement一般滑鼠事件處理的預設執行會Mouse.PreviewMouseDown接聽並將它轉換為適當的本機事件。The default implementation for general mouse event handling in ContentElement listens for Mouse.PreviewMouseDown and converts it to an appropriate local event. 如果您想要覆寫此邏輯, 您必須建立衍生類別。If you want to override this logic, you must create a derived class. 在衍生類別的靜態函式中, 註冊的替代類別處理常式Mouse.PreviewMouseDownIn the static constructor of your derived class, register an alternative class handler for Mouse.PreviewMouseDown. 您無法藉ContentElement由覆寫OnPreviewMouseLeftButtonDown來變更的滑鼠處理行為。You cannot change the mouse handling behavior of ContentElement by overriding OnPreviewMouseLeftButtonDown.

或者, 您可以覆寫這個方法, 以便變更特定滑鼠狀態的事件處理。Alternatively, you can override this method in order to change event handling for a specific mouse state. 您是否選擇呼叫基底實作為您的案例。Whether you choose to call the base implementation depends on your scenario. 無法呼叫 base 會停用該滑鼠事件在也預期OnPreviewMouseLeftButtonDown會叫用之祖系類別上的預設輸入處理。Failing to call base disables default input handling for that mouse event on ancestor classes that also expect to invoke OnPreviewMouseLeftButtonDown. 例如, 您可以在衍生類別Button中衍生OnPreviewMouseLeftButtonDown自和覆寫, 而不需要呼叫基底實作為Click , 不過, 此覆寫會停用事件。For example, you can derive from Button and override OnPreviewMouseLeftButtonDown in your derived class without calling the base implementation; however, this override disables the Click event.