Vue d’ensemble du modèle objet Outlook

Pour développer des compléments VSTO pour Microsoft Office Outlook, vous pouvez interagir avec les objets fournis par le modèle objet Outlook. Le modèle objet Outlook fournit des classes et des interfaces qui représentent des éléments dans l’interface utilisateur. Par exemple, l’objet Application représente l’ensemble de l’application, l’objet Folder représente un dossier qui contient des messages électroniques ou d’autres éléments, et l’objet MailItem représente un message électronique.

Cette rubrique fournit une brève vue d’ensemble de certains des objets principaux dans le modèle objet Outlook. Pour plus d’informations sur l’ensemble du modèle objet Outlook, consultez la documentation relative au modèle objet Outlook.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de complément VSTO pour Outlook. Pour plus d’informations, consultez Fonctionnalités disponibles par type d’application et de projet Office.

Accéder aux objets dans un projet Outlook

Outlook fournit de nombreux objets avec lesquels vous pouvez interagir. Pour utiliser efficacement le modèle objet, vous devez être familiarisé avec les objets de niveau supérieur suivants :

• Application

• Explorer

• Inspector

• Folder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Objet Application

L’objet Application représente l’application Outlook et il s’agit de l’objet de niveau le plus élevé dans le modèle objet Outlook. Voici quelques-uns des membres les plus importants de cet objet :

• Méthode CreateItem que vous pouvez utiliser pour créer un élément tel qu’un message électronique, une tâche ou un rendez-vous.

• Propriété Explorers , que vous pouvez utiliser pour accéder aux fenêtres qui affichent le contenu d’un dossier dans l’interface utilisateur Outlook.

• 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 message électronique ou une demande de réunion.

  Pour obtenir une instance de l’objet Application , utilisez le champ Application de la ThisAddIn classe dans votre projet. Pour plus d’informations, consultez Programmer des compléments VSTO.

Objet d'explorateur

L’objet Explorer représente une fenêtre qui affiche le contenu d’un dossier qui contient des éléments tels que des messages électroniques, des tâches ou des rendez-vous. L’objet Explorer inclut des méthodes et des propriétés que vous pouvez utiliser pour modifier la fenêtre et les événements déclenchés lorsque la fenêtre change.

Pour obtenir un Explorer objet, effectuez l’une des opérations suivantes :

• Utilisez la Explorers propriété de l’objet Application pour accéder à tous les Explorer objets dans Outlook.

• Utilisez la méthode ActiveExplorer de l'objet Application pour obtenir le Explorer actuellement focalisé.

• Utilisez la GetExplorer méthode de l’objet Folder pour obtenir le Explorer dossier actif.

Objet Inspector

L’objet Inspector représente une fenêtre qui affiche un seul élément, tel qu’un message électronique, une tâche ou un rendez-vous. L’objet Inspector inclut des méthodes et des propriétés que vous pouvez utiliser pour modifier la fenêtre et les événements déclenchés lorsque la fenêtre change.

Pour obtenir un Inspector objet, effectuez l’une des opérations suivantes :

• Utilisez la Inspectors propriété de l’objet Application pour accéder à tous les Inspector objets dans Outlook.

• Utilisez la méthode ActiveInspector de l’objet Application pour obtenir l’élément Inspector qui a actuellement le focus.

• Utilisez la méthode GetInspector d'un élément donné, tel qu'un MailItem ou AppointmentItem, pour récupérer l'Inspector associé à celui-ci.

Objet Folder

L’objet Folder représente un dossier qui contient des messages électroniques, des contacts, des tâches et d’autres éléments. Outlook fournit 16 objets par défaut Folder .

Les objets par défaut Folder sont définis par les valeurs d’énumération OlDefaultFolders . Par exemple,

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

Pour obtenir un exemple montrant comment accéder à une valeur par défaut Folder et créer un nouvel Folderélément, consultez Guide pratique pour créer des éléments de dossier personnalisés par programmation.

Objet MailItem

L’objet MailItem représente un message électronique. MailItem les objets se trouvent généralement dans des dossiers, tels que boîte de réception, Éléments envoyés et Boîte de réception. MailItem expose les propriétés et méthodes qui peuvent être utilisées pour créer et envoyer des messages électroniques.

Pour obtenir un exemple montrant comment créer un message électronique, voir How to: Programmatically create an email item.

AppointmentItem (objet)

L’objet AppointmentItem représente une réunion, un rendez-vous à usage unique ou un rendez-vous périodique ou une réunion dans le dossier Calendrier . L’objet AppointmentItem inclut des méthodes qui effectuent des actions telles que la réponse ou le transfert de demandes de réunion, ainsi que des propriétés qui spécifient des détails de réunion tels que l’emplacement et l’heure.

Pour obtenir un exemple montrant comment créer un rendez-vous, consultez Guide pratique pour créer une demande de réunion par programmation.

Objet TaskItem

L’objet TaskItem représente une tâche à effectuer dans un délai spécifié. TaskItem les objets se trouvent dans le dossier Tâches .

Pour créer une tâche, utilisez la méthode CreateItem de l’objet Application et transmettez la valeur olTaskItem du paramètre.

Objet ContactItem

L’objet ContactItemreprésente un contact dans le dossier Contacts . ContactItem les objets contiennent diverses informations de contact pour les personnes qu’ils représentent, telles que les adresses postales, les adresses de messagerie et les numéros de téléphone.

Pour obtenir un exemple montrant comment créer un contact, consultez Guide pratique pour ajouter par programmation une entrée aux contacts Outlook. Pour obtenir un exemple montrant comment rechercher un contact existant, consultez Guide pratique pour rechercher par programmation un contact spécifique.

Utiliser la documentation du modèle objet Outlook

Pour obtenir des informations complètes sur le modèle objet d'Outlook, vous pouvez consulter la référence pour l'assembly d'interopérabilité principal (PIA) Outlook et la référence du modèle objet de VBA.

Informations de référence sur l’assembly d’interopérabilité principale

Les documents de référence de l'assembly d'interopérabilité primaire (PIA) d'Outlook répertorient les types dans les assemblies d'interopérabilité primaires pour Outlook 2010. Pour plus d’informations, consultez la référence de l'assembly d'interopérabilité principale Outlook 2010.

En plus de fournir des informations pour tous les types dans les PIAs (Assemblées d'interopérabilité primaires), cette documentation fournit également des informations supplémentaires sur la structure des PIAs et des exemples de code pour les tâches d’automatisation courantes dans Outlook.

Référence du modèle objet VBA

Le document de référence du modèle objet VBA explique le modèle objet Outlook tel qu’il est exposé au code VBA (Visual Basic pour Applications). Pour plus d’informations, consultez la référence du modèle objet Outlook 2010.

Tous les objets et membres de la référence du modèle objet VBA correspondent aux types et membres de l'assembly PIA d'Outlook. Par exemple, l’objet Inspector dans la référence du modèle objet VBA correspond à l’objet Inspector dans l’assembly PIA Outlook. Bien que la référence du modèle objet VBA fournit des exemples de code pour la plupart des propriétés, méthodes et événements, vous devez traduire le code VBA dans cette référence en Visual Basic ou Visual C# si vous souhaitez les utiliser dans un projet VSTO Outlook Add-In que vous créez à l’aide de Visual Studio.

Rubriques connexes