UIElement.PreviewMouseLeftButtonDown Zdarzenie

Definicja

Występuje, gdy lewy przycisk myszy jest naciskany, gdy wskaźnik myszy znajduje się nad tym elementem.

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 

Typ zdarzenia

Implementuje

Uwagi

Chociaż to zdarzenie kierowane wydaje się podążać za trasą tunelowania przez drzewo elementów, jest to zdarzenie kierowane bezpośrednio, które jest wywoływane i ponownie zbierane wzdłuż drzewa elementów przez każdy UIElementelement .

To zdarzenie jest jednym z kilku powiązanych zdarzeń, które zgłaszają specyfikę przycisku myszy bazowego Mouse.PreviewMouseDown zdarzenia, które jest dołączonym zdarzeniem przetwarzanym przez każdy element wzdłuż trasy zdarzeń.

Dane zdarzenia tego zdarzenia uwidacznia dane zdarzenia bazowego Mouse.PreviewMouseDown . Jeśli to zdarzenie jest oznaczone jako obsługiwane wzdłuż trasy zdarzeń, zdarzenia specyficzne dla przycisku myszy są nadal zgłaszane; należy jednak dodać programy obsługi zdarzeń specyficznych dla przycisku myszy przez jawne wywołanie AddHandlermetody , z opcją obsługi zdarzeń, które są już oznaczone jako obsługiwane, aby odbiorniki do zdarzenia. Jeśli oznaczysz PreviewMouseLeftButtonDown je jako obsługiwane, oznaczasz jako obsługiwane Mouse.PreviewMouseDown dla wszystkich kolejnych odbiorników wzdłuż trasy i we wszystkich powiązanych zdarzeniach. Może to dotyczyć zdarzeń generowanych przez program obsługi klas, takich jak PreviewMouseDoubleClick.

Koncepcyjnie pomyśl o tym zdarzeniu (i innych zdarzeniach przycisku myszy na UIElement), aby być "usługą" myszy (z definicją usługi dostarczaną przez klasę Mouse ). Zdarzenie dodaje wygodę, aby nie trzeba było sprawdzać stanów przycisków myszy (w prawo po lewej, w górę) oryginalnych zdarzeń myszy w danych zdarzenia. W przypadku bardziej zaawansowanych scenariuszy, takich jak sprawdzanie stanów przycisków niestandardowych, może być konieczne użycie interfejsów API w Mouse klasie, a nie tych w UIElementsystemie .

Informacje dotyczące kierowanego zdarzenia

Pole identyfikatora PreviewMouseLeftButtonDownEvent
Strategia routingu Direct
Delegat MouseButtonEventHandler

Dotyczy

Zobacz też