PresentationSource.AddSourceChangedHandler Método

  • Referencia

Definición

Espacio de nombres:
System.Windows
Ensamblado:
PresentationCore.dll

Agrega un controlador para el evento SourceChanged al elemento proporcionado.

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)

Parámetros

element
IInputElement

Elemento al que se va a agregar el controlador.

handler
SourceChangedEventHandler

Implementación del controlador que se agregará.

Atributos
SecurityCriticalAttribute

Comentarios

A pesar de lo que indica el bloque de sintaxis de este evento, no hay ningún uso legítimo de la propiedad adjunta del lenguaje de marcado de aplicación extensible (XAML). No debe intentar agregar controladores en lenguaje de marcado de aplicaciones extensibles (XAML) y los controladores en el código solo deben colocarse en objetos que actúan como hosts para el contenido de la presentación (PresentationSource ). Estos controladores solo se deben adjuntar durante la inicialización de objetos y deben quitarse explícitamente en un método Dispose o en una limpieza de objetos equivalente.

Aunque se trata de un evento enrutado, hay restricciones especiales colocadas en este evento que difieren del comportamiento normal del evento enrutado, debido al número relativamente pequeño de elementos en un escenario de aplicación típico que se preocuparía por controlar este evento.

  • No se pueden usar los UIElement métodos o ContentElementAddHandler para agregar controladores. Se debe usar AddSourceChangedHandler.

  • No se admiten las sintaxis del controlador de eventos y -= C# += y las sintaxis de controlador relacionadas específicas del lenguaje, ya que el propio evento no se expone como público. Solo se admiten los PresentationSource métodos de utilidad para agregar y quitar los controladores directamente.

  • No se permiten controladores de clases. En concreto, no se puede llamar RegisterClassHandler a en este evento en un constructor de clase porque, aunque existe un campo de identificador para SourceChanged, el identificador no es público.

  • Todos los controladores registrados recibirán el evento SourceChanged incluso si uno de los controladores intenta marcar los argumentos como controlado.

Se aplica a