Partager via

RoutedEventArgs Classe

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml
Modifier

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

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

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

RoutedEventArgs est un type de données d’événement courant utilisé pour les événements d’élément de base dans l’application UWP à l’aide de C++, C# ou Visual Basic. Généralement RoutedEventArgs comme 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 leur gestion, consultez Vue d’ensemble des événements et des événements routés.

L’API que 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é l’événement pour les scénarios de test d’accès et de routage des événements, mais il arrive également que l’expéditeur de la signature déléguée soit 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 êtes familiarisé avec Windows Presentation Foundation (WPF), vous savez peut-être que Windows Presentation Foundation (WPF) déclare une propriété nommée Handled sur la classe RoutedEventArgs. Certaines classes de données d’événements routées dans le Windows Runtime également définir une propriété Handled, et vous l’utilisez de la même façon que dans Windows Presentation Foundation (WPF) (elle influence l’itinéraire des événements à partir de votre gestionnaire).) Toutefois, pour Windows Runtime et pour Microsoft Silverlight, 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 Windows Presentation Foundation (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

RoutedEventArgs est la classe parente de 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 pour 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 sont pas parfois ont les données d’événement dérivées de RoutedEventArgs pour des raisons de 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’un modèle faisant partie 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