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

L'elemento a cui aggiungere il gestore.

handler

SourceChangedEventHandler

L'implementazione del gestore da aggiungere.

Commenti

Nonostante il blocco di sintassi per questo evento, non esiste un utilizzo legittimo della proprietà associata Extensible Application Markup Language (XAML). Non è consigliabile tentare di aggiungere gestori nel linguaggio XAML (Extensible Application Markup Language) e i gestori nel codice devono essere inseriti solo negli oggetti che fungono da host per la 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 nella pulizia di oggetti equivalente.

Anche se si tratta di un evento instradato, esistono restrizioni speciali per questo evento che differiscono dal comportamento normale degli eventi indirizzati, a causa del numero relativamente ridotto di elementi in uno scenario applicazione tipico che si preoccupa di gestire questo evento.

• Non è possibile usare i UIElement metodi o ContentElementAddHandler per aggiungere gestori. È necessario utilizzare AddSourceChangedHandler.

• Le sintassi del gestore eventi e C# += e -= le sintassi del gestore specifiche del linguaggio correlate non sono supportate, perché l'evento stesso non è esposto come pubblico. Sono supportati solo i PresentationSource metodi di utilità per aggiungere e rimuovere direttamente i gestori.

• I gestori di classi non sono consentiti. In particolare, non è possibile chiamare RegisterClassHandler questo evento in un costruttore di classi perché, anche se esiste 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.