Partekatu honen bidez:

Conexión con controladores de eventos personalizados

Outlook genera eventos para notificar a los complementos sobre algo que está sucediendo, como que la Bandeja de entrada está recibiendo un nuevo elemento de correo. Los complementos pueden indicar a Outlook que lleve a cabo determinadas acciones ante la repetición de un evento específico. Este mecanismo de alerta y devolución de llamada es compatible con delegados de .NET Framework. El ensamblado de interoperabilidad primario (PIA) de Outlook define delegados a los que puede conectar métodos de devolución de llamada para controlar los eventos correspondientes. En este tema se describe este proceso, que consiste en definir un método de devolución de llamada y conectarlo como un controlador de eventos para el objeto de Outlook.

Creación de un método de devolución de llamada

Una devolución de llamada es un método que se implementa para controlar la repetición de un evento específico, y se ejecuta por origen de notificación. En Outlook, los complementos pueden implementar métodos de devolución de llamada para responder a determinados eventos generados por Outlook. El método de devolución de llamada debe coincidir con la firma del delegado del evento. Por ejemplo, para implementar un controlador de eventos para el evento ItemSend, debe declarar el método de devolución de llamada que coincida con la firma del delegado correspondiente:

public delegate void ApplicationEvents_11_ItemSendEventHandler(object Item, ref bool Cancel)

Public Delegate Sub ApplicationEvents_11_ItemSendEventHandler(_
    ByVal Item As Object, ByRef Cancel As Boolean)

Al definir el método de devolución de llamada, ignore la palabra clave Delegate que definiría otro delegado. A continuación se muestra un método de devolución de llamada de ejemplo, MyItemSendEventHandler:

public void MyItemSendEventHandler(object Item, ref bool Cancel)

Public Sub MyItemSendEventHandler (_
    ByVal Item As Object, ByRef Cancel As Boolean)
…
End Sub

Conexión a un método de devolución de llamada

Después de implementar un método de devolución de llamada para un evento, puede conectarlo al objeto de Outlook para que Outlook llame al método como controlador de eventos de dicho evento. Tenga en cuenta que un evento se puede controlar con más de un controlador de eventos y éste es el punto donde entran en juego los delegados que asignan el control de eventos a los controladores de eventos.

Continuando con el último ejemplo de especificación de un controlador de eventos para el evento ItemSend del objeto Application , para conectar MyItemSendEventHandler al objeto Application en C#, crear una instancia del objeto delegado, pasar MyItemSendEventHandler al constructor del objeto delegado y, a continuación, agregar este objeto delegado al evento ItemSend mediante el operador +=:

app.ItemSend += new ApplicationEvents_11_ItemSendEventHandler(MyItemSendEventHandler)

En Visual Basic, deberá usar la instrucción AddHandler para asociar el evento ItemSend al controlador de eventos MyItemSendEventHandler:

AddHandler app.ItemSend, AddressOf MyItemSendEventHandler

Vea también