UIElement.MouseLeftButtonDown Událost

Definice

Vyvolá se při stisknutí levého tlačítka myši, zatímco ukazatel myši je nad tímto prvkem.

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 

Event Type

Implementuje

Poznámky

I když se zdá, že tato směrovaná událost prochází bublající cestou stromem prvků, ve skutečnosti se jedná o přímou směrovanou událost, která je každou z nich UIElementvyvolána a znovu provedena ve stromu prvků .

Tato událost je jednou z několika souvisejících událostí, které oznamují specifika tlačítka myši související Mouse.MouseDown události, což je přidružená událost, kterou každý prvek zpracovává na trase události.

Data události této události zpřístupňují data události podkladové Mouse.MouseDown události. Pokud je tato událost označena jako zpracována podél trasy události, jsou stále vyvolány události specifické pro tlačítko myši; Obslužné rutiny událostí specifických pro tlačítko myši však musí být přidány explicitním voláním AddHandlers možností zpracování událostí, které jsou již označeny jako zpracované, aby byly naslouchací procesy události. Pokud označíte MouseLeftButtonDown jako zpracované, označíte Mouse.MouseDown v podstatě zpracování pro všechny další naslouchací procesy podél trasy a u všech souvisejících událostí. To může zahrnovat události generované obslužnou rutinou třídy, jako MouseDoubleClickje .

Koncepčně si tuto událost (a další události tlačítka myši na UIElement) představte jako službu myši (s definicí služby poskytovanou Mouse třídou ). Událost zvyšuje pohodlí v tom, že není nutné kontrolovat stavy tlačítek myši (vlevo vpravo, nahoru a dolů) původních událostí myši v datech události. V pokročilejších scénářích, jako je kontrola stavů nestandardních tlačítek, možná budete muset použít rozhraní API Mouse ve třídě, nikoli rozhraní API na UIElement.

Důležité

Některé třídy ovládacích prvků mohou mít vlastní zpracování tříd pro události tlačítka myši. Událost levého tlačítka myši dolů je nejpravděpodobnější událostí zpracování třídy v ovládacím prvku. Zpracování třídy často označuje podkladovou Mouse událost třídy jako zpracovanou. Jakmile je událost označena jako obslužná, ostatní obslužné rutiny instance, které jsou připojeny k danému prvku, nejsou obvykle vyvolány. Žádné jiné třídy nebo obslužné rutiny instance, které jsou připojeny k prvkům ve směru bublání směrem ke kořenu ve stromu uživatelského rozhraní, nejsou také obvykle aktivovány.

Problém, který je popsán v předchozí části Důležité a stále přijímat MouseLeftButtonDown události pro události levého tlačítka myši dolů v odvozené třídě, která má zpracování třídy, můžete vyřešit pomocí některého z těchto řešení:

  • Připojit obslužné rutiny pro PreviewMouseDown událost, která není označena jako zpracovávaná ovládacími prvky. Všimněte si, že vzhledem k tomu, že se jedná o událost preview, trasa začíná v kořenovém adresáři a tuneluje se dolů k ovládacímu prvku.

  • Zaregistrujte obslužnou rutinu na ovládacím prvku procedurálně voláním AddHandler a zvolením možnosti podpisu, která umožňuje obslužným rutinám naslouchat událostem, i když jsou již označeny jako zpracované ve směrovaných datech událostí.

Informace o směrované události

Pole Identifikátor MouseLeftButtonDownEvent
Strategie směrování Direct
Delegát MouseButtonEventHandler
  • Přepsání OnMouseLeftButtonDown pro implementaci zpracování třídy pro tuto událost v odvozených třídách.

Platí pro

Viz také