Working with Outlook Events

Outlook propose un large éventail d'événements qui lui permettent d'informer vos programmes Microsoft Visual Basic, Microsoft Visual Basic pour Applications (VBA) et Microsoft Visual Basic Scripting Edition (VBScript) que des modifications importantes ont été apportées. Par exemple, les événements Outlook permettent d'informer un programme de l'ouverture d'un élément ou de l'arrivée d'un nouveau message dans la Boîte de réception.

Pour recevoir une notification concernant un événement important, vous devez écrire une procédure de gestionnaire d'événements. Selon que l’événement est géré en Visual Basic ou Visual Basic pour Applications ou en VBScript, il s’agit d’un ou d’un SubFunction que Outlook appelle quand l’événement est appelé. Le code écrit dans le gestionnaire d'événements permet à votre programme de répondre à l'événement de façon appropriée et, dans certains cas, d'annuler l'action par défaut associée à l'événement, comme par exemple empêcher l'envoi d'un élément de messagerie.

Types d'événements

Les événements Outlook se répartissent en deux catégories principales : les événements de niveau élément et les événements de niveau application.

Les événements de niveau élément se rattachent à un élément particulier et sont gérés par le code VBScript contenu dans le formulaire associé à l'élément. Ces événements informent votre programme lorsqu'un élément a été ouvert, envoyé, publié, enregistré ou fermé et lorsque l'utilisateur a répondu à un message ou l'a transféré, ou encore lorsqu'il a initié une action personnalisée. Les événements de niveau élément permettent également d'informer votre programme lorsque l'utilisateur a cliqué sur un contrôle dans le formulaire ou lorsqu'une propriété d'élément a été modifiée.

Les événements de niveau application sont généralement gérés par du code Visual Basic ou Visual Basic pour Applications car ils se rattachent à plusieurs éléments, outre ceux associés à un formulaire particulier. Les événements de niveau application peuvent se rattacher à l'application elle-même, aux collections et fenêtres d'explorateur (notamment le volet de raccourcis), aux collections et fenêtres d'inspecteur, aux dossiers et collections de dossiers, aux collections d'éléments et aux objets de synchronisation.

Réponse aux événements

Pour répondre aux événements de niveau élément, vous devez ajouter des procédures de gestionnaire d'événements au script du formulaire qui affiche l'élément. Par exemple, pour exécuter du code lorsqu'un élément est ouvert dans le formulaire, ajoutez une procédure au script du formulaire, comme celle indiquée ci-dessous.

Function Item_Open() 
 MsgBox "A new item has opened in this form." 
End Function

Répondre aux événements de niveau application constitue une opération plus complexe, car vous devez prendre des mesures afin d'associer le gestionnaire d'événements à la partie d'Outlook où l'événement survient. Obtenir des informations sur l'écriture d'un gestionnaire d'événement de niveau application.

Ordre des événements

À l'exception de certains événements de formulaires, votre programme ne peut pas supposer que les événements vont se produire dans un ordre donné, même s'ils semblent être appelés selon une séquence cohérente. L'ordre dans lequel Outlook appelle les gestionnaires d'événements peut varier en fonction d'autres événements qui peuvent survenir ou cet ordre est susceptible d'être modifié dans les versions à venir de Microsoft Outlook.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.