Share via

RoutedEventArgs Classe

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

Contient des données d’événements et des informations état associées à un événement routé.

/// [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
Héritage
Object IInspectable RoutedEventArgs
Dérivé
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Remarques

RoutedEventArgsest un type de données d’événement courant utilisé pour les événements d’élément de base dans les applications SDK d'application Windows à l’aide de C++ ou C#. En règle générale RoutedEventArgs , comme le type de données d’événement indique que l’événement avec ces données d’événement est un événement routé, bien qu’il existe quelques exceptions. Pour plus d’informations sur les événements routés et la façon de les gérer, consultez Vue d’ensemble des événements et des événements routés.

L’API qui RoutedEventArgs ajoute à un jeu de données d’événement généralisé est OriginalSource. OriginalSource peut être utile pour déterminer l’élément qui a déclenché l’événement pour les scénarios de test d’accès et de routage d’événements, mais il existe également des moments où l’expéditeur de la signature déléguée est la référence d’objet source la plus utile pour un gestionnaire. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.

RoutedEventArgs et la propriété Handled

Si vous connaissez Windows Presentation Foundation (WPF), vous savez peut-être que WPF déclare une propriété nommée Handled sur la RoutedEventArgs classe . Certaines classes de données d’événements routées dans le Windows Runtime également définir une Handled propriété, et vous l’utilisez de la même façon que dans WPF (cela influence l’itinéraire des événements à partir de votre gestionnaire.) Toutefois, pour SDK d'application Windows ce comportement est spécifique uniquement à certains événements routés plutôt qu’à tous les événements routés (comme c’est le cas dans WPF). Par exemple, vous pouvez définir Handled si vous gérez un événement de pointeur et que la classe de données d’événement est PointerRoutedEventArgs, mais vous ne pouvez pas définir Handled pour un événement Loaded où les données d’événement sont un instance RoutedEventArgs.

Classes dérivées RoutedEventArgs

RoutedEventArgsest la classe parente de plusieurs classes dérivées immédiatement qui définissent des données d’événement pour les événements Windows Runtime impliquant des éléments d’interface utilisateur. Tous les événements dans lesquels les classes fournissent des données ne sont pas nécessairement des événements routés, comme défini dans La vue d’ensemble des événements et des événements routés. Mais beaucoup le sont. Ceux qui ne le sont pas parfois ont les données d’événement dérivées de pour des raisons de RoutedEventArgs compatibilité.

Constructeurs

RoutedEventArgs()

Initialise une nouvelle instance de la classe RoutedEventArgs.

Propriétés

OriginalSource

Obtient une référence à l’objet qui a déclenché l’événement. Il s’agit souvent d’une partie de modèle d’un contrôle plutôt que d’un élément qui a été déclaré dans l’interface utilisateur de votre application.

S’applique à

Voir aussi