Langage

RoutedEventArgs Classe

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

Contient des informations d’état et des données d’événement 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 SDK d'application Windows applications utilisant 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é, même s’il existe certaines exceptions. Pour plus d’informations sur les événements routés et sur la façon de les gérer, consultez la vue d’ensemble des événements routés et des événements routés.

L’API qui RoutedEventArgs ajoute à un jeu de données d’événements généralisé est OriginalSource. OriginalSource peut être utile pour déterminer l’élément qui a déclenché d’abord l’événement pour les scénarios de test d’accès et de routage des événements, mais il existe également des moments où l’expéditeur de la signature de délégué est la référence d’objet source 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 définissent également une Handled propriété et vous l’utilisez de la même façon que dans WPF (elle 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 vrai 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 une instance RoutedEventArgs.

Classes dérivées RoutedEventArgs

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

Constructeurs

Nom Description
RoutedEventArgs()

Initialise une nouvelle instance de la classe RoutedEventArgs .

Propriétés

Nom Description
OriginalSource

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

S’applique à

Voir aussi