Postupy: Vytvoření vlastní směrované události
Aby vaše vlastní událost podporovala směrování událostí, musíte zaregistrovat RoutedEvent pomocí metody RegisterRoutedEvent. Tento příklad ukazuje základy vytvoření vlastní směrované události.
Příklad
Jak je znázorněno v následujícím příkladu, nejprve zaregistrujete RoutedEvent pomocí metody RegisterRoutedEvent. Podle konvence by název statického pole RoutedEvent měl končit příponou Event. V tomto příkladu je název události Tap
a strategie směrování události je Bubble. Po volání registrace můžete pro událost zadat přístupové metody pro přidání a odebrání událostí CLR (Common Language Runtime).
Všimněte si, že i když je událost vyvolána prostřednictvím OnTap
virtuální metody v tomto konkrétním příkladu, způsob vyvolání události nebo reakce události na změny závisí na vašich potřebách.
Všimněte si také, že tento příklad v podstatě implementuje celou podtřídu Button; tato podtřída je vytvořena jako samostatné sestavení a pak vytvořena jako vlastní třída na samostatné stránce XAML. To je ilustrovat koncept, že podtříděné ovládací prvky lze vložit do stromů složené z jiných ovládacích prvků, a že v této situaci vlastní události na těchto ovládacích prvcích mají velmi stejné možnosti směrování událostí jako jakýkoli nativní prvek WPF.
public class MyButtonSimple: Button
{
// Create a custom routed event by first registering a RoutedEventID
// This event uses the bubbling routing strategy
public static readonly RoutedEvent TapEvent = EventManager.RegisterRoutedEvent(
"Tap", RoutingStrategy.Bubble, typeof(RoutedEventHandler), typeof(MyButtonSimple));
// Provide CLR accessors for the event
public event RoutedEventHandler Tap
{
add { AddHandler(TapEvent, value); }
remove { RemoveHandler(TapEvent, value); }
}
// This method raises the Tap event
void RaiseTapEvent()
{
RoutedEventArgs newEventArgs = new RoutedEventArgs(MyButtonSimple.TapEvent);
RaiseEvent(newEventArgs);
}
// For demonstration purposes we raise the event when the MyButtonSimple is clicked
protected override void OnClick()
{
RaiseTapEvent();
}
}
Public Class MyButtonSimple
Inherits Button
' Create a custom routed event by first registering a RoutedEventID
' This event uses the bubbling routing strategy
Public Shared ReadOnly TapEvent As RoutedEvent = EventManager.RegisterRoutedEvent("Tap", RoutingStrategy.Bubble, GetType(RoutedEventHandler), GetType(MyButtonSimple))
' Provide CLR accessors for the event
Public Custom Event Tap As RoutedEventHandler
AddHandler(ByVal value As RoutedEventHandler)
Me.AddHandler(TapEvent, value)
End AddHandler
RemoveHandler(ByVal value As RoutedEventHandler)
Me.RemoveHandler(TapEvent, value)
End RemoveHandler
RaiseEvent(ByVal sender As Object, ByVal e As RoutedEventArgs)
Me.RaiseEvent(e)
End RaiseEvent
End Event
' This method raises the Tap event
Private Sub RaiseTapEvent()
Dim newEventArgs As New RoutedEventArgs(MyButtonSimple.TapEvent)
MyBase.RaiseEvent(newEventArgs)
End Sub
' For demonstration purposes we raise the event when the MyButtonSimple is clicked
Protected Overrides Sub OnClick()
Me.RaiseTapEvent()
End Sub
End Class
<Window
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:custom="clr-namespace:SDKSample;assembly=SDKSampleLibrary"
x:Class="SDKSample.RoutedEventCustomApp"
>
<Window.Resources>
<Style TargetType="{x:Type custom:MyButtonSimple}">
<Setter Property="Height" Value="20"/>
<Setter Property="Width" Value="250"/>
<Setter Property="HorizontalAlignment" Value="Left"/>
<Setter Property="Background" Value="#808080"/>
</Style>
</Window.Resources>
<StackPanel Background="LightGray">
<custom:MyButtonSimple Name="mybtnsimple" Tap="TapHandler">Click to see Tap custom event work</custom:MyButtonSimple>
</StackPanel>
</Window>
Události tunelování se vytvářejí stejným způsobem, ale s RoutingStrategy nastavenou na Tunnel při volání registrace. Podle konvence mají události tunelování ve WPF jako předponu slovo "Preview".
Pro zobrazení příkladu, jak fungují události probublávání, viz Zpracování směrované události.
Viz také
- Přehled
směrovaných událostí - Přehled vstupu
- Přehled vytváření ovládacích prvků
.NET Desktop feedback