PresentationSource.AddSourceChangedHandler Metódus

Definíció

Hozzáad egy kezelőt az SourceChanged eseményhez a megadott elemhez.

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éterek

element
IInputElement

A kezelőt hozzáadni kívánt elem.

handler
SourceChangedEventHandler

A hozzáadni kívánt kezelő implementációja.

Attribútumok

Megjegyzések

Annak ellenére, hogy az esemény szintaxisblokkja azt állítja, nem létezik az XAML-hez csatolt, helyes extensible Application Markup Language (Extensible Application Markup Language, XAML) tulajdonsághasználat. Az XAML(Extensible Application Markup Language, XAML) nyelvben nem szabad kezelőket hozzáadni, és a kódkezelőket csak olyan objektumokra szabad helyezni, amelyek a bemutató (PresentationSource ) tartalom gazdagépeiként szolgálnak. Ezeket a kezelőket csak az objektum inicializálása során szabad csatlakoztatni, és explicit módon el kell távolítani egy törlési vagy azzal egyenértékű objektumkarbantartási módszerrel.

Annak ellenére, hogy ez egy irányított esemény, különleges korlátozások vonatkoznak erre az eseményre, amelyek eltérnek a normál irányított esemény viselkedésétől, mivel egy tipikus alkalmazásforgatókönyv viszonylag kis számú elemét érinti az esemény kezelése.

  • A kezelők hozzáadásához nem használhatja a UIElement metódusokat vagy ContentElementAddHandler a metódusokat. Használnia kell AddSourceChangedHandler.

  • A C# += és -= az eseménykezelő szintaxisa, valamint a kapcsolódó nyelvspecifikus kezelői szintaxisok nem támogatottak, mivel maga az esemény nem nyilvános. Csak a PresentationSource kezelők közvetlen hozzáadására és eltávolítására szolgáló segédprogramok támogatottak.

  • Az osztálykezelők nem engedélyezettek. Ez az esemény nem hívható RegisterClassHandler meg egy osztálykonstruktorban, mert bár a SourceChanged azonosítómezője létezik, az azonosító nem nyilvános.

  • Minden regisztrált kezelő akkor is megkapja a SourceChanged eseményt, ha az egyik kezelő megkísérli kezelni az argumentumokat.

A következőre érvényes: