PresentationSource.AddSourceChangedHandler Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Aggiunge un gestore per l'evento SourceChanged all'elemento fornito.

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)

Parametri

element

IInputElement

Elemento a cui aggiungere il gestore.

handler

SourceChangedEventHandler

Implementazione del gestore da aggiungere.

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.