Personnalisation de Microsoft Outlook à l'aide de compléments COM
La création d'un complément COM comprend deux étapes principales :
- Implémenter l'interface IDTExtensibility2 dans un module de classe d'une bibliothèque de liens dynamiques (DLL).
- Enregistrer le complément COM.
Implémenter l'interface IDTExtensibility2
L'interface IDTExtensibility2 est constituée de cinq procédures événementielles. 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 :
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. Vous pouvez également copier les procédures vides à partir d’un modèle de complément COM Outlook.
Enregistrer le complément COM
Pour pouvoir fonctionner avec Outlook, la DLL du complément doit être enregistrée. L'identificateur de classe de la DLL est enregistré sous le sous-arbre \HKEY_CLASSES_ROOT de la base de registres.
Les informations concernant le complément doivent en outre être ajoutées à la base de registres. 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.
Note Si vous utilisez Microsoft Visual Basic 6.0 ou version ultérieure Développeur pour concevoir votre complément COM, le concepteur de complément effectue les étapes requises pour inscrire le complément COM pour vous.
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.
[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.
| Valeur | Description |
|---|---|
| 2 | Charger au démarrage. Le complément COM est chargé et connecté au démarrage de Microsoft Outlook. |
| 8 | Charger à la demande. 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. |
| 16 | Connecter la première fois. 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. Lors de l'exécution suivante de Microsoft Outlook, le complément COM est chargé au moment où l'utilisateur le demande. 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). |
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.
| Indicateur | Description |
|---|---|
| 0 | Déconnecté |
| 1 | Connecté |
Pour connecter le complément COM, affectez l'indicateur Connecté à LoadBehavior ; désactivez cet indicateur pour déconnecter le complément COM.
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 . La valeur Description fournit des informations supplémentaires sur le complément COM.
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.