次の方法で共有

方法: カスタム ルーティング イベントを作成する

  • [アーティクル]

カスタム イベントがイベント ルーティングをサポートするには、RegisterRoutedEvent メソッドを使用して RoutedEvent を登録する必要があります。 この例では、カスタム ルーティング イベントの作成の基本を示します。

例

次の例に示すように、最初に RegisterRoutedEvent メソッドを使用して RoutedEvent を登録します。 慣例により、 静的フィールド名の末尾には、イベントサフィックスを付けます。 この例では、イベントの名前が Tap され、イベントのルーティング戦略が Bubbleされます。 登録呼び出しの後、イベントの共通言語ランタイム (CLR) イベント アクセサーを追加および削除できます。

この特定の例の OnTap 仮想メソッドを通じてイベントが発生する場合でも、イベントを発生させる方法や変更に対するイベントの応答方法はニーズによって異なります。

また、この例では基本的に Buttonのサブクラス全体を実装します。そのサブクラスは別のアセンブリとしてビルドされ、別の XAML ページでカスタム クラスとしてインスタンス化されます。 これは、サブクラス化されたコントロールを他のコントロールで構成されるツリーに挿入できる概念を示しています。この状況では、これらのコントロールのカスタム イベントには、ネイティブ 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>

トンネリング イベントは同じように作成されますが、登録呼び出しで RoutingStrategyTunnel に設定されます。 慣例により、WPF のトンネリング イベントの先頭には "Preview" という単語が付いています。

バブル イベントのしくみの例については、「ルーティング イベントの処理 」を参照してください。

参照