ContentElement.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 dann die Ereignisdateninstanz verwendet, um ein benutzerdefiniertes routingfähiges Ereignis zu auslösen.

void RaiseTapEvent()
{
  RoutedEventArgs newEventArgs = new RoutedEventArgs();
  newEventArgs.RoutedEvent = MyCustomLink.TapEvent;
  //newEvent.SetSource(this);
  RaiseEvent(newEventArgs);
}

Private Sub RaiseTapEvent()
  Dim newEventArgs As New RoutedEventArgs()
  newEventArgs.RoutedEvent = MyCustomLink.TapEvent
  'newEvent.SetSource(Me)
  MyBase.RaiseEvent(newEventArgs)
End Sub

Hinweise

Der Parameter wird als allgemeiner Basistyp für alle weitergeleiteten Ereignisdaten eingegeben. Die e Ereignisdaten sollten jedoch als spezifischste 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 sie ausgelöst wird.

RoutedEventArgs ist nicht nur die Zustandseigenschaften für das Ereignis; Es identifiziert auch, welche Routed-Ereignis ausgelöst werden soll. Dieses Ereignisaufhebungsmuster und die weitergeleiteten Ereignisdaten unterscheiden sich sowohl von gemeinsamen Sprach-Runtime-Ereignissen und Datenklassen als auch von Datenklassen, die normalerweise nur Eigenschaften enthalten, die sich auf das Ereignis beziehen.