PresentationSource.AddSourceChangedHandler Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Ajoute un gestionnaire pour l’événement SourceChanged à l’élément fourni.

public:
 static void AddSourceChangedHandler(System::Windows::IInputElement ^ element, System::Windows::SourceChangedEventHandler ^ handler);

public static void AddSourceChangedHandler (System.Windows.IInputElement element, System.Windows.SourceChangedEventHandler handler);

static member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unit

Public Shared Sub AddSourceChangedHandler (element As IInputElement, handler As SourceChangedEventHandler)

Paramètres

element

IInputElement

Élément auquel ajouter le gestionnaire.

handler

SourceChangedEventHandler

Implémentation du gestionnaire à ajouter.

Remarques

Malgré ce que le bloc de syntaxe de cet événement indique, il n’existe aucune utilisation légitime de la propriété jointe XAML (Extensible Application Markup Language). Vous ne devez pas tenter d’ajouter des gestionnaires au langage XAML (Extensible Application Markup Language) et les gestionnaires du code doivent uniquement être placés sur des objets qui servent d’hôtes pour le contenu de présentation (PresentationSource). Ces gestionnaires ne doivent être attachés qu’au cours de l’initialisation de l’objet et doivent être supprimés explicitement dans une méthode Dispose ou un nettoyage d’objet équivalent.

Même s’il s’agit d’un événement routé, il existe des restrictions spéciales placées sur cet événement qui diffèrent du comportement normal des événements routés, en raison du nombre relativement faible d’éléments dans un scénario d’application classique qui se préoccupent de la gestion de cet événement.

• Vous ne pouvez pas utiliser les méthodes UIElement ou ContentElementAddHandler pour ajouter des gestionnaires. Vous devez utiliser AddSourceChangedHandler.

• Les syntaxes des gestionnaires d’événements C# += et -= et des syntaxes de gestionnaire spécifiques au langage associées ne sont pas prises en charge, car l’événement lui-même n’est pas exposé en tant que public. Seules les méthodes utilitaires PresentationSource pour l’ajout et la suppression des gestionnaires directement sont prises en charge.

• Les gestionnaires de classes ne sont pas autorisés. Plus précisément, vous ne pouvez pas appeler RegisterClassHandler par rapport à cet événement dans un constructeur de classe, car même si un champ d’identificateur existe pour SourceChanged, l’identificateur n’est pas public.

• Tous les gestionnaires inscrits reçoivent l’événement SourceChanged même si l’un des gestionnaires tente de marquer les arguments comme gérés.