Connexion de gestionnaires d’événements personnalisés
Outlook déclenche des événements pour notifier les compléments de quelque chose qui se passe, comme la Boîte de réception qui reçoit un nouvel élément de courrier. Les compléments peuvent indiquer à Outlook qu'en cas d'occurrence d'un événement spécifique, certaines actions doivent être entreprises. Ce mécanisme d'alerte et de rappel est pris en charge par les délégués du .NET Framework. L'assembly PIA (Primary Interop Assembly) Outlook définit les délégués auxquels vous pouvez connecter des méthodes de rappel pour gérer des événements correspondants. Cette rubrique décrit le processus de définition d'une méthode de rappel et de sa connexion à l'objet Outlook en tant que gestionnaire d'événements.
Création d’une méthode de rappel
Un rappel est une méthode implémentée pour gérer l'occurrence d'un événement spécifique et est exécuté par une source de notification. Dans Outlook, les compléments peuvent implémenter des méthodes de rappel afin de répondre à certains événements déclenchés par Outlook. Cette méthode de rappel doit correspondre à la signature du délégué de cet événement. Par exemple, pour implémenter un gestionnaire d'événements pour l'événement ItemSend, vous devez déclarer la méthode de rappel qui correspond à la signature du délégué correspondant :
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)
Lors de la définition de la méthode de rappel, ignorez le mot clé Delegate qui définit sinon un autre délégué. Un exemple de méthode de rappel, MyItemSendEventHandler, est illustré ci-dessous :
public void MyItemSendEventHandler(object Item, ref bool Cancel)
Public Sub MyItemSendEventHandler (_
ByVal Item As Object, ByRef Cancel As Boolean)
…
End Sub
Connexion d’une méthode de rappel
Après avoir implémenté une méthode de rappel pour un événement, vous pouvez la connecter à l'objet Outlook afin qu'Outlook sache qu'il doit appeler cette méthode comme gestionnaire d'événements pour cet événement. Notez qu'un événement peut être géré par plusieurs gestionnaires d'événements, d'où la nécessité de délégués qui affectent la gestion des événements aux gestionnaires d'événements.
Pour reprendre l'exemple précédent qui spécifie un gestionnaire d'événements pour l'événement ItemSend de l'objet Application, pour connecter MyItemSendEventHandler à l'objet Application en C#, créez une instance de l'objet délégué, passez MyItemSendEventHandler au constructeur de cet objet, puis ajoutez l'objet délégué à l'événement ItemSend en utilisant l'opérateur += :
app.ItemSend += new ApplicationEvents_11_ItemSendEventHandler(MyItemSendEventHandler)
En Visual Basic, utilisez l'instruction AddHandler pour associer l'événement ItemSend au gestionnaire d'événements MyItemSendEventHandler:
AddHandler app.ItemSend, AddressOf MyItemSendEventHandler