Personnalisation de Microsoft Outlook à l'aide de compléments COMCustomizing Outlook using COM add-ins

La création d'un complément COM comprend deux étapes principales :Creating a COM add-in involves two major steps:

  1. Implémenter l'interface IDTExtensibility2 dans un module de classe d'une bibliothèque de liens dynamiques (DLL).Implement the IDTExtensibility2 interface in a class module of a dynamic link library (DLL).
  2. Enregistrer le complément COM.Register the COM add-in.

Implémenter l'interface IDTExtensibility2Implement the IDTExtensibility2 Interface

L'interface IDTExtensibility2 est constituée de cinq procédures événementielles.The IDTExtensibility2 interface consists of five event procedures. Pour implémenter cette interface dans un programme Visual Basic, vous devez définir une référence à la bibliothèque d'objets Microsoft Add-In Designer, puis ajouter l'instruction suivante à la section Déclarations d'un module de classe :To implement this interface in a Visual Basic program, set a reference to the Microsoft Add-In Designer object library and then add the following statement to the Declarations section of a class module:

Implements IDTExtensibility2

Vous pouvez ensuite ajouter les procédures événementielles vides à la fenêtre de code du module de classe et ajouter votre propre code de programme aux procédures.You can then add the empty event procedures to the code window of the class module and add your own program code to the procedures. Vous pouvez également copier les procédures vides à partir d’un modèle de complément COM Outlook.You can also copy the empty procedures from an Outlook COM Add-in Template.

Enregistrer le complément COMRegister the COM add-in

Pour pouvoir fonctionner avec Outlook, la DLL du complément doit être enregistrée.In order to work with Outlook, the add-in DLL must be registered. L'identificateur de classe de la DLL est enregistré sous le sous-arbre \HKEY_CLASSES_ROOT de la base de registres.The DLL's class ID is registered beneath the \HKEY_CLASSES_ROOT subtree in the registry.

Les informations concernant le complément doivent en outre être ajoutées à la base de registres.In addition, information about the add-in must be added to the registry. Ces informations permettent de connaître le nom du complément, sa description, l'application cible, le comportement de chargement initial et l'état de connexion.This information provides the add-in's name, description, target application, initial load behavior, and connection state.

Remarque Si vous utilisez Microsoft Visual Basic 6.0 ou une version ultérieure de Developer pour créer votre complément COM, l'outil de création de compléments effectue les procédures nécessaires à l'enregistrement du complément COM à votre place.Note If you use Microsoft Visual Basic 6.0 or later Developer to design your COM add-in, the add-in designer will perform the steps required to register the COM add-in for you.

L'exemple suivant montre comment afficher le contenu d'un exemple de fichier de l'éditeur du Registre (.reg) qui illustre la procédure d'enregistrement d'un complément COM Outlook.The following example shows the contents of a sample registry-editor (.reg) file that illustrates how to register an Outlook COM add-in.

   [HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\SampleAddIn.AddInIFace]
    "FriendlyName"="Sample Add-in"
    "Description"="Sample Outlook Add-In"
    "LoadBehavior"=dword:00000008

Lorsque le complément COM est enregistré pour la première fois, LoadBehavior peut se voir affecter l'un des indicateurs ci-dessous.When the COM add-in is first registered, LoadBehavior can be set to any of the following flags.

ValeurValue DescriptionDescription
2 2 Charger au démarrage.Load at startup. Le complément COM est chargé et connecté au démarrage de Microsoft Outlook.The COM add-in is to be loaded and connected when Outlook starts.
8 8 Charger à la demande.Load on demand. Le complément COM est chargé et connecté uniquement lorsque l'utilisateur le demande, en utilisant par exemple la boîte de dialogue Compléments COM.The COM add-in is to be loaded and connected only when the user requests it, such as by using the COM Add-ins dialog box.
16 16 Connecter la première fois.Connect first time. Le complément COM est chargé et connecté la première fois que l'utilisateur exécute Outlook après l'enregistrement du complément COM.The COM add-in is loaded and connected the first time the user runs Outlook after the COM add-in has been registered. Lors de l'exécution suivante de Microsoft Outlook, le complément COM est chargé au moment où l'utilisateur le demande.The next time Outlook is run, the COM add-in is loaded when the user requests it. Utilisez cette valeur si votre complément COM modifie l'interface utilisateur pour permettre à l'utilisateur de demander la connexion du complément COM sur demande (en cliquant sur un bouton par exemple).Use this value if your COM add-in modifies the user interface to allow the user to request the COM add-in be connected on demand (by clicking a button, for example).

Une fois que le complément COM est enregistré et chargé, la valeur LoadBehavior peut être associée à l'un des deux indicateurs ci-dessous pour indiquer l'état de connexion actuel du complément COM.After the COM add-in is registered and loaded, the LoadBehavior value can be combined with either of the following two flags to indicate current connection state of the COM add-in.

IndicateurFlag DescriptionDescription
00 DéconnectéDisconnected
1 1 ConnectéConnected

Pour connecter le complément COM, affectez l'indicateur Connecté à LoadBehavior ; désactivez cet indicateur pour déconnecter le complément COM.To connect the COM add-in, set the Connected flag in LoadBehavior; clear the flag to disconnect the COM add-in.

La valeur FriendlyName spécifie le nom du complément COM tel qu’il est affiché dans la boîte de dialogue complément COM .The FriendlyName value specifies the name of the COM add-in as it's displayed in the COM Add-in dialog box. La valeur Description fournit des informations supplémentaires sur le complément COM.The Description value provides additional information about the COM add-in.

Assistance et commentairesSupport and feedback

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ?Have questions or feedback about Office VBA or this 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.