RoutedEventArgs Klasse

  • Referenz

Definition

Namespace:
Windows.UI.Xaml
Bearbeiten

Enthält Zustandsinformationen und Ereignisdaten, die einem Routingereignis zugeordnet sind.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RoutedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class RoutedEventArgs
Public Class RoutedEventArgs
Vererbung
Object IInspectable RoutedEventArgs
Abgeleitet
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

RoutedEventArgs ist ein allgemeiner Ereignisdatentyp, der für Basiselementereignisse in der UWP-App mit C++, C# oder Visual Basic verwendet wird. Im Allgemeinen gibt RoutedEventArgs als Ereignisdatentyp an, dass das Ereignis mit diesen Ereignisdaten ein Routingereignis ist, obwohl es einige Ausnahmen gibt. Weitere Informationen zu Routingereignissen und deren Behandlung finden Sie unter Übersicht über Ereignisse und routingfähige Ereignisse.

Die API, die RoutedEventArgs einem generalisierten Ereignisdatensatz hinzufügt, ist OriginalSource. OriginalSource kann nützlich sein, um das Element zu bestimmen, das das Ereignis zuerst für Treffertests und Ereignisroutingszenarien ausgelöst hat, aber es gibt auch Zeiten, in denen der Absender aus der Delegatensignatur der nützlichere Quellobjektverweis für einen Handler ist. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

RoutedEventArgs und die Handled-Eigenschaft

Wenn Sie mit Windows Presentation Foundation (WPF) vertraut sind, wissen Sie möglicherweise, dass Windows Presentation Foundation (WPF) eine Eigenschaft mit dem Namen Handled für die RoutedEventArgs-Klasse deklariert. Bestimmte Routingereignisdatenklassen in der Windows-Runtime auch eine Handled-Eigenschaft definieren, und Sie verwenden sie auf die gleiche Weise wie in Windows Presentation Foundation (WPF) (sie beeinflusst die Ereignisroute aus ihrem Handler.) Für Windows-Runtime und auch für Microsoft Silverlight ist dieses Verhalten jedoch nur für bestimmte weitergeleitete Ereignisse und nicht für alle weitergeleiteten Ereignisse spezifisch (wie in Windows Presentation Foundation (WPF)). Sie können z. B. Handled festlegen, wenn Sie ein Zeigerereignis behandeln und die Ereignisdatenklasse PointerRoutedEventArgs lautet, aber Sie können Handled nicht für ein Loaded-Ereignis festlegen, bei dem die Ereignisdaten eine RoutedEventArgs-instance sind.

Abgeleitete RoutedEventArgs-Klassen

RoutedEventArgs ist die übergeordnete Klasse für mehrere sofort abgeleitete Klassen, die Ereignisdaten für Windows-Runtime Ereignisse mit Ui-Elementen definieren. Nicht alle Ereignisse, bei denen die Klassen Daten bereitstellen, sind notwendigerweise Routingereignisse, wie in der Übersicht über Ereignisse und routingfähige Ereignisse definiert. Aber viele sind es. Diejenigen, bei denen die Ereignisdaten aus Kompatibilitätsgründen manchmal nicht von RoutedEventArgs abgeleitet sind.

Konstruktoren

RoutedEventArgs()

Initialisiert eine neue instance der RoutedEventArgs-Klasse.

Eigenschaften

OriginalSource

Ruft einen Verweis auf das -Objekt ab, das das Ereignis ausgelöst hat. Dies ist häufig ein Vorlagenteil eines Steuerelements und nicht ein Element, das in Ihrer App-Benutzeroberfläche deklariert wurde.

Gilt für:

Weitere Informationen