Nasıl yapılır: Özel Gönderilmiş Olay Oluşturma
Olay yönlendirmeyi desteklemek için özel olaylarınızın, RoutedEvent yöntemini kullanarak kaydetmeniz gerekir RegisterRoutedEvent . Bu örnekte, özel bir yönlendirilmiş olay oluşturmanın temelleri gösterilmektedir.
Örnek
Aşağıdaki örnekte gösterildiği gibi, öncelikle yöntemini kullanarak bir kayıt kaydedersiniz RoutedEventRegisterRoutedEvent . Kurala göre RoutedEvent statik alan adı, son ek RoutedEventile bitmelidir. Bu örnekte, olayın adı Tap ve olay yönlendirme stratejisidir Bubble . Kayıt çağrısından sonra, olay için ortak dil çalışma zamanı (CLR) olay erişimcileri ekleme ve kaldırma sağlayabilirsiniz.
Olay OnTap Bu özel örnekteki sanal yöntem üzerinden oluşturulsa da, olaylarınızı nasıl yükseltebileceğinizi veya olaylarınızın değişikliklere nasıl yanıt vereceğini, gereksinimlerinize bağlı olarak unutmayın.
Ayrıca bu örnek, temel olarak bir alt sınıfının tamamını uygular Button ; Bu alt sınıf ayrı bir derleme olarak oluşturulur ve ardından ayrı bir Extensible Application Markup Language (XAML) sayfasında özel bir sınıf olarak oluşturulur. bu, alt sınıflı denetimlerin diğer denetimlerden oluşan ağaçlara eklenebilme kavramını göstermek ve bu durumda, bu denetimlerde özel olayların herhangi bir yerel Windows Presentation Foundation (WPF) öğesiyle aynı olay yönlendirme yeteneklerine sahip olduğunu gösterir.
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>
Tünel olayları aynı şekilde oluşturulur, ancak RoutingStrategyTunnel kayıt çağrısında olarak ayarlanır. Kurala göre, WPF 'de tünel olayları "Preview" kelimesiyle ön ek olarak uygulanır.
Kabarcıklanma olaylarının nasıl çalıştığı hakkında bir örnek görmek için bkz. yönlendirilmiş olayı işleme.