كيفية القيام بما يلي: إنشاء حدث موجه مخصص

لكي يدعم الحدث المخصص بك توجيه الحدث ، تحتاج إلى تسجيل RoutedEvent باستخدام RegisterRoutedEvent الأسلوب. يوضح هذا المثال أساسيات إنشاء الأحداث الموجهة المخصصة.

مثال

كما هو مبين في المثال التالي, يجب أولاً تسجيل RoutedEvent باستخدام RegisterRoutedEvent الأسلوب. بواسطة الاصطلاح RoutedEvent يجب أن ينتهي حقل الاسم الثابت بالأحداث اللاحقة . في هذا المثال, اسم الحدث هو Tap و استراتيجية توجيه الحدث هي Bubble. بعد استدعاء التسجيل يمكنك توفير حدث إضافة - و - إزالة وقت تشغيل اللغة العامة (CLR) موصلين الحدث.

لاحظ أنه على الرغم من أن الحدث يتم تنفيذه خلال OnTap أسلوب ظاهري في هذا المثال المعين أو كيفية تنفيذ الحدث أو كيفية استجابة الحدث للتغييرات التي تعتمد على احتياجاتك.

لاحظ أيضاً أن هذا المثال يقوم بتطبيق فئة فرعية بأكملها بشكل أساسي Button; يتم بناء تلك الفئة الفرعية كتجميع منفصل و ثم إنشاء مثيل كفئة مخصصة على صفحة منفصلة Extensible Application Markup Language (XAML) . هذا لتوضيح مفهوم عناصر التحكم في فئة فرعية الذي يمكن إدراجه في أشجار مؤلفة من عناصر تحكم أخرى وهو في هذه الحالة، الأحداث المخصصة على عناصر التحكم هذه لها نفس قدرات توجيه الحدث مثل أي العنصر أصلي Windows Presentation Foundation (WPF) .

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

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();
    }

}

<Window  
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://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>

يتم إنشاء أحداث نفق بنفس الطريقة ولكن RoutingStrategy يتم تعيينها إلى Tunnel في إتصال التسجيل. بواسطة الاصطلاح ، أحداث النفق في WPF مسبوقة بكلمة "معاينة".

لرؤية مثال عن كيفية عمل أحداث الاتصال الفقاعي, راجع كيفية القيام بما يلي: معالجة حدث موجًّه‬.

راجع أيضًا:

المبادئ

نظرة عامة حول الأحداث الموجهة

نظرة عامة حول المدخلات

نظرة عامة على تأليف التحكم