Sdílet prostřednictvím

Postupy: Vytvoření vlastní směrované události

  • Článek

Aby vaše vlastní událost podporovala směrování událostí, musíte pomocí této metody zaregistrovat RoutedEventRegisterRoutedEvent . 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 metodu RoutedEventRegisterRoutedEvent . Podle konvence by název statického RoutedEvent pole měl končit příponou Event. V tomto příkladu je Tap název události a strategie směrování události je Bubble. Po volání registrace můžete pro událost zadat doplňky a odebrat přístupové objekty událostí clr (Common Language Runtime).

Mějte na paměti, ž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 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 sestavena jako samostatné sestavení a poté 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 jsou RoutingStrategy nastavené na Tunnel volání registrace. Podle konvence jsou události tunelování ve WPF předponou slovem "Preview".

Příklad fungování bublinových událostí najdete v tématu Zpracování směrované události.

Viz také