ComAwareEventInfo.AddEventHandler(Object, Delegate) 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í.
Asocia un controlador de eventos a un objeto COM.
public:
override void AddEventHandler(System::Object ^ target, Delegate ^ handler);
public override void AddEventHandler (object target, Delegate handler);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public override void AddEventHandler (object target, Delegate handler);
override this.AddEventHandler : obj * Delegate -> unit
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
override this.AddEventHandler : obj * Delegate -> unit
Public Overrides Sub AddEventHandler (target As Object, handler As Delegate)
Parámetros
- target
- Object
El objeto de destino con que el delegado de eventos debería enlazar.
- handler
- Delegate
El delegado de eventos.
- Atributos
Comentarios
Este método es similar al EventInfo.AddEventHandler(Object, Delegate) método, excepto que permite adjuntar eventos a objetos COM.
Si target
es un objeto COM, este método agrega un delegado a un evento mediante el ComEventsHelper.Combine(Object, Guid, Int32, Delegate) método .
AddEventHandler facilita el registro de receptores de eventos COM que reenvía llamadas a los delegados administrados correspondientes. Requiere la siguiente información:
El propio objeto de destino (
target
).GUID de la interfaz de origen.
DispID del método en la interfaz COM que corresponde al evento especificado.
Delegado que se invocaría cuando el objeto COM desencadena el evento correspondiente (
handler
).
AddEventHandler busca la interfaz de origen COM correspondiente (especificada como primer parámetro del ComEventInterfaceAttribute.ComEventInterfaceAttribute(Type, Type) constructor). A continuación, busca un método en la interfaz de origen cuyo nombre es idéntico al nombre del evento. El valor de en la interfaz de GuidAttribute
origen es el GUID que se pasa a ComEventsHelper.Combine(Object, Guid, Int32, Delegate); el valor de DispIDAttribute
en el método es el valor DispID que se pasa a ComEventsHelper.Combine(Object, Guid, Int32, Delegate).