Vorgehensweise: Erstellen eines benutzerdefinierten RoutingereignissesHow to: Create a Custom Routed Event

Damit das benutzerdefinierte Ereignis das Ereignis Routing unterstützt, müssen Sie ein RoutedEvent mit der RegisterRoutedEvent -Methode registrieren.For your custom event to support event routing, you need to register a RoutedEvent using the RegisterRoutedEvent method. Dieses Beispiel zeigt die Grundlagen der Erstellung eines benutzerdefinierten Routingereignisses.This example demonstrates the basics of creating a custom routed event.

BeispielExample

Wie im folgenden Beispiel gezeigt, registrieren RoutedEvent Sie zunächst mithilfe der RegisterRoutedEvent -Methode.As shown in the following example, you first register a RoutedEvent using the RegisterRoutedEvent method. Gemäß der Konvention sollte RoutedEvent der statische Feldname mit dem Suffix- Ereignisenden.By convention, the RoutedEvent static field name should end with the suffix Event. In diesem Beispiel ist Tap der Name des Ereignisses, und die Routing Strategie des Ereignisses ist. BubbleIn this example, the name of the event is Tap and the routing strategy of the event is Bubble. Nach dem Registrierungs Befehl können Sie Add-and-Remove Common Language Runtime (CLR)-Ereignisaccessoren für das Ereignis bereitstellen.After the registration call, you can provide add-and-remove common language runtime (CLR) event accessors for the event.

Beachten Sie, dass die Art, obwohl das Ereignis in diesem speziellen Beispiel über die virtuelle Methode OnTap ausgelöst wird, wie Sie das Ereignis auslösen oder wie Ihr Event auf Änderungen reagiert, von Ihren Anforderungen abhängt.Note that even though the event is raised through the OnTap virtual method in this particular example, how you raise your event or how your event responds to changes depends on your needs.

Beachten Sie auch, dass in diesem Beispiel grundsätzlich eine gesamte unter ButtonKlasse von implementiert wird. Diese Unterklasse wird als separate Assembly erstellt und dann als benutzerdefinierte Klasse auf einer separaten Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) Seite instanziiert.Note also that this example basically implements an entire subclass of Button; that subclass is built as a separate assembly and then instantiated as a custom class on a separate Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) page. Dadurch wird veranschaulicht, dass Steuerelemente als Unterklasse in Strukturen, die aus anderen Steuerelementen zusammengesetzt sind, eingefügt werden können, und in diesem Fall benutzerdefinierte Ereignisse dieser Steuerelemente über die gleichen Ereignisroutingfunktionen wie jedes native Element von Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) verfügen.This is to illustrate the concept that subclassed controls can be inserted into trees composed of other controls, and that in this situation, custom events on these controls have the very same event routing capabilities as any native Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) element does.

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>

Tunnelingereignisse werden auf die gleiche Weise erstellt, wobei RoutingStrategy jedoch im Tunnel Registrierungs Befehl auf festgelegt ist.Tunneling events are created the same way, but with RoutingStrategy set to Tunnel in the registration call. In WPFWPF erhalten Tunneling-Ereignissen per Konvention das Wort „Preview“ als Präfix.By convention, tunneling events in WPFWPF are prefixed with the word "Preview".

Ein Beispiel der Funktionsweise des Bubbling von Ereignissen finden Sie unter Behandeln eines Routingereignisses.To see an example of how bubbling events work, see Handle a Routed Event.

Siehe auchSee also