Freigeben über

RoutedEventArgs Klasse

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

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

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

Hinweise

RoutedEventArgsist ein gängiger Ereignisdatentyp, der für Basiselementereignisse in Windows App SDK Apps mit C++ oder C# verwendet wird. Im Allgemeinen RoutedEventArgs gibt der 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 Routingereignisse.

Die API, die einem generalisierten Ereignisdatensatz hinzugefügt wird, RoutedEventArgs 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 Fälle, 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 WPF eine Eigenschaft namens Handled für die RoutedEventArgs Klasse deklariert. Bestimmte Routingereignisdatenklassen im Windows-Runtime auch eine Handled Eigenschaft definieren, und Sie verwenden sie auf die gleiche Weise wie in WPF (sie beeinflusst die Ereignisroute in Ihrem Handler).) Für Windows App SDK dieses Verhalten jedoch nur für bestimmte Routingereignisse spezifisch und nicht für alle Routingereignisse (wie in WPF zutrifft). Sie können beispielsweise Handled festlegen, wenn Sie ein Zeigerereignis behandeln und die Ereignisdatenklasse PointerRoutedEventArgs lautet. Sie können jedoch nicht für ein Loaded-Ereignis festlegenHandled, bei dem die Ereignisdaten eine RoutedEventArgs-instance.

Abgeleitete RoutedEventArgs-Klassen

RoutedEventArgsist die übergeordnete Klasse für mehrere direkt abgeleitete Klassen, die Ereignisdaten für Windows-Runtime Ereignisse definieren, die UI-Elemente enthalten. Nicht alle Ereignisse, bei denen die Klassen Daten bereitstellen, sind notwendigerweise Routingereignisse, wie in der Übersicht über Ereignisse und Routingereignisse definiert. Aber viele sind es. Diejenigen, von denen aus Kompatibilitätsgründen manchmal nicht die Ereignisdaten abgeleitet RoutedEventArgs werden.

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 der App-Benutzeroberfläche deklariert wurde.

Gilt für:

Weitere Informationen