UIElement3D.AddHandler Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega un controlador de eventos enrutados para un evento enrutado especificado. Para ello, agrega el controlador a la colección de controladores en el elemento actual.
Sobrecargas
| AddHandler(RoutedEvent, Delegate) |
Agrega un controlador de eventos enrutados para un evento enrutado especificado. Para ello, agrega el controlador a la colección de controladores en el elemento actual. |
| AddHandler(RoutedEvent, Delegate, Boolean) |
Agrega un controlador de eventos enrutados para un evento enrutado especificado. Para ello, agrega el controlador a la colección de controladores en el elemento actual. Especifique |
AddHandler(RoutedEvent, Delegate)
Agrega un controlador de eventos enrutados para un evento enrutado especificado. Para ello, agrega el controlador a la colección de controladores en el elemento actual.
public:
virtual void AddHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);public void AddHandler (System.Windows.RoutedEvent routedEvent, Delegate handler);abstract member AddHandler : System.Windows.RoutedEvent * Delegate -> unit
override this.AddHandler : System.Windows.RoutedEvent * Delegate -> unitPublic Sub AddHandler (routedEvent As RoutedEvent, handler As Delegate)Parámetros
- routedEvent
- RoutedEvent
Identificador del evento enrutado que se va a controlar.
- handler
- Delegate
Referencia a la implementación del controlador.
Implementaciones
Comentarios
Puede agregar el mismo controlador para el mismo evento varias veces sin generar una excepción. Sin embargo, el controlador se invoca varias veces cuando se controla el evento. Por lo tanto, considere cómo este comportamiento podría tener efectos secundarios que se deben tener en cuenta en la implementación del controlador.
Normalmente se usa este método para proporcionar la implementación del descriptor de acceso "add" para el patrón de acceso a eventos de Microsoft .NET de un evento enrutado personalizado.
Se aplica a
AddHandler(RoutedEvent, Delegate, Boolean)
Agrega un controlador de eventos enrutados para un evento enrutado especificado. Para ello, agrega el controlador a la colección de controladores en el elemento actual. Especifique handledEventsToo como true para que el controlador proporcionado se invoque para eventos enrutados que estén marcados como controlados por otro elemento en la ruta del evento.
public:
void AddHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler, bool handledEventsToo);public void AddHandler (System.Windows.RoutedEvent routedEvent, Delegate handler, bool handledEventsToo);member this.AddHandler : System.Windows.RoutedEvent * Delegate * bool -> unitPublic Sub AddHandler (routedEvent As RoutedEvent, handler As Delegate, handledEventsToo As Boolean)Parámetros
- routedEvent
- RoutedEvent
Identificador del evento enrutado que se va a controlar.
- handler
- Delegate
Referencia a la implementación del controlador.
- handledEventsToo
- Boolean
true para registrar el controlador invocado, aunque el evento enrutado esté marcado como controlado en los datos de evento; false para registrar el controlador con la condición predeterminada de que no se invocará si el evento enrutado ya está marcado como controlado.
De manera predeterminada, es false.
No solicite de manera rutinaria volver a controlar un evento enrutado.
Comentarios
El procesamiento de eventos de entrada de bajo nivel de forma práctica es una tarea compleja. Muchos controles implementan el comportamiento en el que un determinado evento se marca como controlado y se reemplaza por otro evento más intuitivo. Por lo general, un control solo marcará un evento de entrada de plataforma como controlado si hay alguna intención de diseño para hacerlo. En determinados escenarios, esas intenciones de diseño podrían no ser lo que requiere su control concreto del evento de entrada. Se trata de estos escenarios en los que se registran los controladores con handledEventsToo según true corresponda. Pero no deberías hacer esto de forma rutinaria. Invocar controladores en respuesta a todos los eventos, incluso si se controla, complicará su propia lógica de procesamiento de eventos de aplicación. Es posible que vea una disminución del rendimiento si la lógica del controlador es sustancial. Debe reservar el uso de controladores de asociación para eventos ya controlados para situaciones en las que ya se ha detectado durante el proceso de desarrollo que determinados controles controlan eventos que todavía desea controlar con la lógica de la aplicación.
Otra técnica para evitar el comportamiento de control de clases de determinadas combinaciones de control de eventos es usar la alternativa de vista previa de ese evento. Por ejemplo, si MouseLeftButtonDown está marcado como controlado por el control de clases, es posible que pueda agregar controladores para PreviewMouseLeftButtonDown en su lugar.
Puede agregar el mismo controlador para el mismo evento varias veces sin generar una excepción. Sin embargo, el controlador se invoca varias veces cuando se controla el evento. Por lo tanto, considere cómo este comportamiento podría tener efectos secundarios que se deben tener en cuenta en la implementación del controlador.
Normalmente se usa este método para proporcionar la implementación del descriptor de acceso "add" para el patrón de acceso a eventos de Microsoft .NET de un evento enrutado personalizado.
