Bagikan melalui

Cara: Membuat Peristiwa Rute Kustom

  • Artikel

Agar peristiwa kustom Anda mendukung perutean peristiwa, Anda perlu mendaftarkan RoutedEvent menggunakan metode .RegisterRoutedEvent Contoh ini menunjukkan dasar-dasar pembuatan peristiwa rute kustom.

Contoh

Seperti yang ditunjukkan dalam contoh berikut, Anda terlebih dahulu mendaftarkan RoutedEvent menggunakan metode .RegisterRoutedEvent Menurut konvensi, RoutedEvent nama bidang statis harus diakhiri dengan Peristiwa akhiran. Dalam contoh ini, nama peristiwa adalah Tap dan strategi perutean acara adalah Bubble. Setelah panggilan pendaftaran, Anda dapat menyediakan pengaktif peristiwa add-and-remove common language runtime (CLR) untuk acara tersebut.

Perhatikan bahwa meskipun peristiwa dimunculkan melalui OnTap metode virtual dalam contoh khusus ini, bagaimana Anda menaikkan acara Anda atau bagaimana peristiwa Anda merespons perubahan tergantung pada kebutuhan Anda.

Perhatikan juga bahwa contoh ini pada dasarnya mengimplementasikan seluruh subkelas Button; bahwa subkelas dibangun sebagai rakitan terpisah dan kemudian dibuat sebagai kelas kustom pada halaman XAML terpisah. Ini untuk mengilustrasikan konsep bahwa kontrol subkelas dapat dimasukkan ke dalam pohon yang terdiri dari kontrol lain, dan bahwa dalam situasi ini, peristiwa kustom pada kontrol ini memiliki kemampuan perutean peristiwa yang sangat sama seperti yang dilakukan elemen WPF asli apa pun.

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>

Peristiwa penerowongan dibuat dengan cara yang sama, tetapi dengan RoutingStrategy diatur ke Tunnel dalam panggilan pendaftaran. Menurut konvensi, peristiwa penerowongan di WPF diawali dengan kata "Pratinjau".

Untuk melihat contoh cara kerja peristiwa yang menggelegak, lihat Menangani Peristiwa Yang Dirutekan.

Baca juga