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 indiqué.

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

[System.Security.SecurityCritical]
public static void AddSourceChangedHandler (System.Windows.IInputElement element, System.Windows.SourceChangedEventHandler handler);

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

[<System.Security.SecurityCritical>]
static member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unit

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.

Attributs

SecurityCriticalAttribute

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 essayer d’ajouter des gestionnaires dans XAML (Extensible Application Markup Language), et les gestionnaires dans le code ne doivent être placés que 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 explicitement supprimés 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 d’un scénario d’application classique qui s’inquièterait de la gestion de cet événement.

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

• Les syntaxes du gestionnaire d’événements et -= C# += et les 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é comme public. Seules les PresentationSource méthodes utilitaires 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 cet événement dans un constructeur de classe, car bien qu’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.