UIElement.RaiseEvent(RoutedEventArgs) Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Löst ein bestimmtes Routingereignis aus. Das auszulösende RoutedEvent wird innerhalb der RoutedEventArgs-Instanz identifiziert, die bereitgestellt wird (als RoutedEvent-Eigenschaft für diese Ereignisdaten).

public:
 virtual void RaiseEvent(System::Windows::RoutedEventArgs ^ e);

public void RaiseEvent (System.Windows.RoutedEventArgs e);

abstract member RaiseEvent : System.Windows.RoutedEventArgs -> unit
override this.RaiseEvent : System.Windows.RoutedEventArgs -> unit

Public Sub RaiseEvent (e As RoutedEventArgs)

Parameter

e

RoutedEventArgs

Ein RoutedEventArgs, das die Ereignisdaten enthält und zudem das auszulösende Ereignis angibt.

Implementiert

RaiseEvent(RoutedEventArgs)

Beispiele

Im folgenden Beispiel werden Ereignisdaten erstellt, der Ereignisbezeichner an die Daten angefügt und anschließend die Ereignisdateninstanz verwendet, um ein benutzerdefiniertes Routingereignis zu auslösen.

void RaiseTapEvent()
{
        RoutedEventArgs newEventArgs = new RoutedEventArgs(MyButtonSimple.TapEvent);
        RaiseEvent(newEventArgs);
}

Private Sub RaiseTapEvent()
    Dim newEventArgs As New RoutedEventArgs(MyButtonSimple.TapEvent)
    MyBase.RaiseEvent(newEventArgs)
End Sub

Hinweise

Der e Parameter wird als gemeinsamer Basistyp für alle Routingereignisdaten eingegeben. Die Ereignisdaten sollten jedoch als den spezifischen Ereignisdatentyp angegeben werden, der für das ausgelöste Ereignis verfügbar ist, da RoutedEventArgs abgeleitete Klassen die tatsächlichen spezifischen Dateneigenschaften enthalten, die für das bestimmte Ereignis vorgesehen sind, wenn es ausgelöst wird.

RoutedEventArgs ist nicht nur die Zustandseigenschaften für das Ereignis; es gibt auch an, welches routingfähige Ereignis ausgelöst werden soll. Dieses Ereignisaufhebungsmuster und die Routingereignisdaten unterscheiden sich beide von common language runtime (CLR)-Ereignissen und Datenklassen, die normalerweise nur Eigenschaften enthalten, die sich auf das Ereignis beziehen.