Share via

RoutedEventArgs.OriginalSource Propriété

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

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.

public:
 property Platform::Object ^ OriginalSource { Platform::Object ^ get(); };
IInspectable OriginalSource();
public object OriginalSource { get; }
var object = routedEventArgs.originalSource;
Public ReadOnly Property OriginalSource As Object

Valeur de propriété

Object

Platform::Object

IInspectable

Objet ayant déclenché l'événement.

Remarques

Lorsqu’un événement routé fait bulle dans un itinéraire d’événement, sender n’est plus le même objet que l’objet qui déclenche l’événement. Au lieu de cela, sender est l’objet dans lequel le gestionnaire appelé est attaché.

Dans certains cas, sender n’est pas intéressant, et vous vous intéressez plutôt à des informations telles que les objets enfants possibles sur lesquels le pointeur se trouve lorsqu’un événement de pointeur s’est déclenché, ou quel objet dans une interface utilisateur plus grande a maintenu le focus lorsqu’un utilisateur a appuyé sur une touche du clavier. Dans ce cas, vous pouvez utiliser la valeur de la OriginalSource propriété . À tous les points de l’itinéraire, OriginalSource signale l’objet d’origine qui a déclenché l’événement, au lieu de l’objet où le gestionnaire est attaché. Toutefois, pour les événements d’entrée UIElement, cet objet d’origine est souvent un objet qui n’est pas immédiatement visible dans le code XAML de définition de l’interface utilisateur au niveau de la page. Au lieu de cela, cet objet source d’origine peut être une partie basée sur un modèle d’un contrôle. Par exemple, si l’utilisateur pointe le pointeur sur le bord d’un bouton, pour la plupart des événements de pointeur, est OriginalSource une partie de modèle Bordure dans le modèle, et non le bouton lui-même. Par conséquent, vous ne pouvez pas toujours compter sur OriginalSource la représentation d’un objet que vous avez spécifiquement déclaré dans vos définitions d’interface utilisateur au niveau de la page XAML.

Conseil

Le bouillonnement d’événements d’entrée est particulièrement utile si vous créez un contrôle avec modèle. Tout contrôle qui possède un modèle peut se voir appliquer un nouveau modèle par son consommateur. Le consommateur qui essaie de recréer un modèle de travail peut involontairement éliminer une gestion des événements déclarée dans le modèle par défaut. Vous pouvez quand même fournir une gestion des événements au niveau du contrôle en attachant des gestionnaires dans le cadre du remplacement de la méthode OnApplyTemplate dans la définition de classe. Vous pouvez ensuite intercepter les événements d’entrée qui se propagent à la racine du contrôle lors de l’instanciation.

S’applique à

Voir aussi