PresentationSource.AddSourceChangedHandler Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Aggiunge un gestore per l'evento SourceChanged all'elemento fornito.
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 -> unitstatic member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unitPublic Shared Sub AddSourceChangedHandler (element As IInputElement, handler As SourceChangedEventHandler)Parametri
- element
- IInputElement
Elemento a cui aggiungere il gestore.
- handler
- SourceChangedEventHandler
Implementazione del gestore da aggiungere.
- Attributi
Commenti
Nonostante il blocco di sintassi per questo evento, non esiste un uso legittimo della proprietà associata XAML (Extensible Application Markup Language). Non è consigliabile provare ad aggiungere gestori in XAML (Extensible Application Markup Language) e i gestori nel codice devono essere inseriti solo su oggetti che fungono da host per il contenuto della presentazione (PresentationSource ). Tali gestori devono essere collegati solo durante l'inizializzazione dell'oggetto e devono essere rimossi in modo esplicito in un metodo Dispose o in una pulizia di oggetti equivalente.
Anche se si tratta di un evento indirizzato, esistono restrizioni speciali applicate a questo evento che differiscono dal normale comportamento degli eventi indirizzati, a causa del numero relativamente ridotto di elementi in uno scenario di applicazione tipico che si preoccupa di gestire questo evento.
Non è possibile utilizzare i metodi UIElement o ContentElementAddHandler per aggiungere gestori. È necessario usare AddSourceChangedHandler.
Le sintassi del gestore eventi C#
+=e-=e le sintassi dei gestori specifici del linguaggio correlate non sono supportate perché l'evento stesso non viene esposto come pubblico. Sono supportati solo i metodi di utilità PresentationSource per aggiungere e rimuovere direttamente i gestori.I gestori di classe non sono consentiti. In particolare, non è possibile chiamare RegisterClassHandler su questo evento in un costruttore di classe perché, sebbene esista un campo identificatore per SourceChanged, l'identificatore non è pubblico.
Tutti i gestori registrati riceveranno l'evento SourceChanged anche se uno dei gestori tenta di contrassegnare gli argomenti come gestiti.
