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'application entière, 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 présentation de certains objets principaux du 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 application Office lication et le type de projet.

Accéder aux objets dans un projet Outlook

Outlook fournit de nombreux objets avec lesquels vous pouvez interagir. Pour utiliser le modèle objet efficacement, 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. Il s'agit de l'objet de niveau supérieur le plus élevé dans le modèle objet Outlook. Voici quelques-uns des membres les plus importants de cet objet :

• la méthode CreateItem , qui vous permet de créer un élément tel qu'un message électronique, une tâche ou un rendez-vous ;

• la propriété Explorers , qui vous permet d'accéder aux fenêtres affichant le contenu d'un dossier dans l'interface utilisateur d'Outlook ;

• la propriété Inspectors , qui vous permet d'accéder aux fenêtres affichant le contenu d'un élément unique, par exemple 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 Les compléments VSTO program.

Remarque

Pour éviter les avertissements de sécurité lorsque vous utilisez des propriétés et des méthodes bloquées par la protection du modèle objet Outlook, obtenez des objets Outlook à partir du champ Application de la ThisAddIn classe. Pour plus d’informations, consultez Considérations relatives à la sécurité spécifiques pour les solutions Bureau.

Objet Explorateur

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

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

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

• Utilisez la méthode ActiveExplorer de l'objet Application pour obtenir le Explorer qui possède actuellement le focus.

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

Objet Inspector

L'objet Inspector représente une fenêtre qui affiche un élément unique, par exemple un message électronique, une tâche ou un rendez-vous. L'objet Inspector inclut les méthodes et propriétés que vous pouvez utiliser pour modifier la fenêtre, ainsi que les événements qui sont déclenchés quand la fenêtre change.

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

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

• Utilisez la méthode ActiveInspector de l'objet Application pour obtenir le Inspector qui possède actuellement le focus.

• Utilisez la méthode GetInspector d'un élément spécifique, par exemple MailItem ou AppointmentItem, pour récupérer l'inspecteur associé.

Objet Folder

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

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

Microsoft. Bureau. 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. Les objetsMailItem se trouvent généralement dans des dossiers, par exemple Boîte de réception, Éléments envoyéset Boîte d'envoi. 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 : Programally create an email item.

AppointmentItem (objet)

L'objet AppointmentItem représente une réunion, un rendez-vous unique, ou un rendez-vous ou une réunion périodique, dans le dossier Calendrier . L'objet AppointmentItem inclut des méthodes qui effectuent des actions telles que répondre à des demandes de réunion ou les transférer, ainsi que des propriétés qui spécifient les détails de la réunion, par exemple le lieu 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 à exécuter dans un laps de temps spécifique. Les objetsTaskItem se trouvent dans le dossier Tâches .

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

Objet ContactItem

L'objet ContactItemreprésente un contact dans le dossier Contacts . Les objetsContactItem contiennent diverses informations de contact pour les personnes qu'ils représentent, par exemple des adresses postales, des adresses de messagerie et des 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 Outlook, vous pouvez consulter la documentation de référence de l'assembly PIA (Primary Interop Assembly) Outlook et la documentation de référence du modèle objet VBA.

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

La documentation de référence de l'assembly PIA Outlook décrit les types des assemblys PIA (Primary Interop Assembly) pour Outlook 2010. Pour plus d’informations, consultez la référence d’assembly d’interopérabilité principale Outlook 2010.

Outre la fourniture d'informations sur tous les types des assemblys PIA (Primary Interop Assembly), cette documentation propose également des informations supplémentaires sur la structure des assemblys PIA (Primary Interop Assembly), ainsi que des exemples de code pour les tâches courantes basées sur la technologie Automation dans Outlook.

Référence du modèle objet VBA

La documentation de référence du modèle objet VBA présente 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 mentionnés dans la documentation de référence du modèle objet VBA correspondent aux types et aux membres de l'assembly PIA 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. Même si la documentation de 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 fourni dans la documentation de référence en Visual Basic ou Visual C# pour pouvoir les utiliser dans un projet de complément Outlook VSTO créé à l'aide de Visual Studio.

Rubriques connexes

Intitulé	Description
Utiliser des éléments de contact	Fournit des rubriques qui montrent comment effectuer des tâches avec des contacts.
Utiliser des éléments de messagerie	Fournit des rubriques qui montrent comment effectuer des tâches avec des éléments de messagerie.
Utiliser des dossiers	Fournit des rubriques qui montrent comment effectuer des tâches avec des dossiers.
Utiliser des éléments de calendrier	Fournit des rubriques qui montrent comment effectuer des tâches avec des éléments du calendrier.
Guide pratique pour déterminer par programmation l’élément Outlook actuel	Montre comment afficher le nom du dossier actuel, ainsi que certaines informations sur l'élément sélectionné.