Vue d'ensemble du modèle d'objet Outlook

Article
04/28/2010

Mise à jour : novembre 2007

Pour développer des compléments destinés à Microsoft Office Outlook, vous pouvez interagir avec les objets fournis par le modèle objet Outlook. Le modèle objet Outlook fournit des classes qui représentent des éléments dans l'interface utilisateur. Par exemple, la classe Application représente l'application entière, la classe MAPIFolder représente un dossier qui contient des courriers électroniques ou d'autres éléments, et la classe MailItem représente un courrier électronique.

Cette rubrique présente brièvement les principales classes contenues dans le modèle objet Outlook. Pour la documentation complète du modèle objet Outlook, consultez les sections MSDN de Référence du développeur Outlook 2007 et Bienvenue dans le Guide de référence du langage VBA de Microsoft Office Outlook 2003 (en anglais).

Accès à des objets dans un projet Outlook

Outlook fournit de nombreuses classes avec lesquelles vous pouvez interagir. Pour utiliser le modèle objet efficacement, vous devez être familiarisé avec les classes de premier niveau suivantes :

Classe Application

La classe Application représente l'application Outlook. Il s'agit de la classe de plus haut niveau dans le modèle objet Outlook. Les membres les plus importants de cette classe sont notamment les suivants :

La méthode CreateItem, que vous pouvez utiliser pour créer un élément tel qu'un courrier électronique, une tâche ou un rendez-vous.
La propriété Explorers, que vous pouvez utiliser pour accéder aux fenêtres qui affichent le contenu d'un dossier dans l'interface utilisateur d'Outlook.
La propriété Inspectors, que vous pouvez utiliser pour accéder aux fenêtres qui affichent le contenu d'un seul élément, tel qu'un courrier électronique ou une demande de réunion.

Pour obtenir une instance de la classe Application, utilisez la propriété Application de la classe ThisAddin.

Classe ThisAddIn

Lorsque vous créez un nouveau projet complément Outlook, Visual Studio Tools pour Office crée automatiquement un fichier de code ThisAddIn.vb ou ThisAddIn.cs dans votre nouveau projet. Ce fichier de code définit une classe ThisAddin qui hérite de OutlookAddIn. Vous pouvez accéder aux membres de la classe OutlookAddIn à l'aide des mots clés Me (en Visual Basic) ou this (en C#) dans la classe ThisAddIn. Le code en dehors de la classe ThisAddIn peut accéder à l'objet ThisAddIn à l'aide de la propriété statique Globals.ThisAddIn.

Remarque :
Afin d'éviter des avertissements de sécurité lorsque vous utilisez des propriétés et des méthodes qui sont bloquées par le module de protection du modèle objet Outlook, récupérez des objets Outlook dans l'objet ThisAddIn. Pour plus d'informations, consultez Considérations spécifiques sur la sécurité pour les solutions Office.

Classe Explorer

La classe Explorer représente une fenêtre qui affiche le contenu d'un dossier contenant des éléments tels que des courriers électroniques, des tâches ou des rendez-vous. La classe Explorer inclut des méthodes et des propriétés que vous pouvez utiliser pour modifier la fenêtre, et des événements qui sont déclenchés lorsque la fenêtre change.

Pour obtenir un objet Explorer, procédez d'une des manières suivantes :

Utilisez la propriété Explorers de la classe Application pour accéder à tous les objets Explorer dans Outlook.
Utilisez la méthode ActiveExplorer de la classe Application pour obtenir le Explorer qui détient actuellement le focus.
Utilisez la méthode GetExplorer de la classe MAPIFolder pour obtenir le Explorer pour le dossier actif.

Classe Inspector

La classe Inspector représente une fenêtre qui affiche un élément unique comme un message électronique, une tâche ou un rendez-vous. La classe Inspector inclut des méthodes et des propriétés que vous pouvez utiliser pour modifier la fenêtre, et des événements qui sont déclenchés lorsque la fenêtre change.

Pour obtenir un objet Inspector, procédez d'une des manières suivantes :

Utilisez la propriété Inspectors de la classe Application pour accéder à tous les objets Inspector dans Outlook.
Utilisez la méthode ActiveInspector de la classe Application pour obtenir le Inspector qui détient actuellement le focus.
Utilisez la méthode GetInspector d'un élément spécifique, comme MailItem ou AppointmentItem, pour récupérer l'inspecteur qui lui est associé.

Classe MAPIFolder

La classe MAPIFolder représente un dossier qui contient des courriers électroniques, des contacts, des tâches et d'autres éléments. Outlook fournit 16 objets MAPIFolder par défaut.

Les objets MAPIFolder par défaut sont définis par les valeurs d'énumération OlDefaultFolders. Par exemple :

T:Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox correspond au dossier Boîte de réception dans Outlook.

Pour obtenir un exemple qui montre comment accéder à un MAPIFolder par défaut et comment créer un MAPIFolder, consultez Comment : créer des éléments de dossier personnalisés.

Classe MailItem

La classe MailItem représente un courrier électronique. Les objets MailItem se trouvent habituellement dans des dossiers, tels que Boîte de réception, Éléments envoyés et Boîte d'envoi. MailItem expose des propriétés et des méthodes qui peuvent être utilisées pour créer et envoyer des courriers électroniques.

Pour obtenir un exemple qui indique comment créer un courrier électronique, consultez Comment : créer un élément de messagerie.

Classe AppointmentItem

La classe AppointmentItem représente une réunion, un rendez-vous unique, ou un rendez-vous ou une réunion périodique dans le dossier Calendrier. La classe AppointmentItem inclut des méthodes qui exécutent des actions telles que répondre à des demandes de réunion ou les transférer, et des propriétés qui spécifient des détails relatifs aux réunions, tels que le lieu et l'heure.

Pour obtenir un exemple qui montre comment créer un rendez-vous, consultez Comment : créer une demande de réunion.

Classe TaskItem

La classe TaskItem représente une tâche à exécuter dans un créneau temporel spécifié. Les objets TaskItem sont localisés dans le dossier Tasks.

Pour créer une tâche, utilisez la méthode CreateItem de la classe Application et passez la valeur olTaskItem pour le paramètre.

Classe ContactItem

La classe ContactItem représente un contact dans le dossier Contacts. Les objets ContactItem contiennent différentes informations de contact correspondant aux personnes qu'ils représentent, notamment les adresses postales et électroniques, ou encore les numéros de téléphone.

Pour obtenir un exemple qui montre comment créer un contact, consultez Comment : ajouter une entrée aux contacts Outlook. Pour obtenir un exemple qui montre comment rechercher un contact existant, consultez Comment : rechercher un contact spécifique.

Utilisation de la documentation du modèle objet Outlook

Pour plus d'informations sur les classes que vous pouvez utiliser dans le modèle objet Outlook, consultez les documentations suivantes :

Le premier lien fournit des informations sur les classes et interfaces de l'assembly PIA (Primary Interop Assembly) pour Outlook. Les autres liens proposent des informations sur le modèle objet Outlook tel qu'il est exposé au code VBA (Visual Basic pour Applications). Chaque document présente des avantages et des inconvénients pour les développeurs qui utilisent Visual Studio Tools pour Office.

Référence d'assembly PIA (Primary Interop Assembly)

Cette documentation décrit tous les types de l'assembly PIA (Primary Interop Assembly) Outlook que vous pouvez utiliser dans des projets Visual Studio Tools pour Office :

Elle décrit les types de l'assembly PIA (Primary Interop Assembly) pour Outlook 2007. Par conséquent, si vous développez un complément Outlook 2003, vous ne pourrez pas utiliser certains des membres et classes mentionnés dans cette documentation. Pour obtenir une description des types et membres disponibles pour Outlook 2003, reportez-vous à « Microsoft Office Outlook 2003 VBA Language Reference ».
Elle ne contient actuellement pas d'exemples de code.

Référence VBA

Tous les objets et membres de la référence VBA correspondent à des classes et des membres de l'assembly PIA (Primary Interop Assembly) que vous utilisez dans des projets Visual Studio Tools pour Office. Par exemple, l'objet Inspector de la documentation relative à VBA pour Outlook correspond à la classe Microsoft.Office.Interop.Outlook.Inspector de l'assembly PIA (Primary Interop Assembly).

La référence VBA présente les avantages suivants :

Elle propose des exemples de code pour la plupart des membres.

La référence VBA présente les inconvénients suivants :

Elle fournit uniquement la syntaxe et des exemples de code pour VBA. Pour utiliser les exemples de code dans un projet Visual Studio Tools pour Office, vous devez traduire le code VBA en Visual Basic ou Visual C#.

Types supplémentaires dans les assemblys PIA

Les assemblys PIA contiennent de nombreux types non disponibles dans VBA. Ces types supplémentaires permettent de convertir des objets du modèle objet COM d'Outlook en code managé. Ils ne sont pas conçus pour être utilisés directement dans votre code.

Pour plus d'informations, consultez Architecture de l'assembly PIA pour Outlook.