Compléments COM Excel et compléments Automation

Compléments COM

Les compléments COM présentent au développeur un moyen d’étendre les fonctionnalités des applications Office pour les tâches personnalisées. Les compléments COM sont généralement utilisés pour automatiser Excel en réponse à un clic sur un bouton CommandBar, un formulaire ou une boîte de dialogue, ou tout autre événement spécifique à Excel, comme l’ouverture ou la fermeture de classeurs ou l’entrée de données dans des feuilles de calcul. Les fonctions de complément COM ne peuvent pas être appelées directement à partir des formules de cellule dans les feuilles de calcul.

Un complément COM est un serveur COM in-process (une DLL ActiveX) qui doit implémenter l’interface IDTExensibility2. Tous les compléments COM doivent implémenter chacune des cinq méthodes de cette interface : OnConnection, OnStartupComplete, OnAddinsUpdate, OnBeginShutDown et OnDisconnection.

Lorsqu’un complément COM est installé sur le système d’un utilisateur, des entrées de Registre sont créées pour le complément. En plus de l’inscription COM normale, un complément COM est inscrit pour chaque application Office dans laquelle il s’exécute. Les compléments COM utilisés par Excel sont inscrits dans la clé de Registre suivante :

            
HKEY_CURRENT_USER\Software\Microsoft\Office\Excel\Addins\

Cette clé contient une sous-clé pour chaque complément COM installé. Le nom de la sous-clé est le ProgID du complément COM. La sous-clé d’un complément COM contient également des valeurs qui décrivent le nom convivial, la description et le comportement de chargement du complément COM. Le comportement de chargement décrit la façon dont le complément est chargé dans Excel : chargé au démarrage, chargé au démarrage suivant uniquement, chargé à la demande ou non chargé.

Les compléments COM peuvent également être chargés et déchargés via l’interface utilisateur Excel. Pour cela, procédez comme suit :

Dans le menu Affichage, pointez sur Barres d’outils, puis cliquez sur Personnaliser.
Dans la boîte de dialogue Barres d’outils, cliquez sur l’onglet Avancé. Dans la liste des catégories, sélectionnez Outils. Recherchez les compléments COM dans la liste des commandes et faites glisser la commande vers un menu ou une barre de commandes de votre choix. Fermez la boîte de dialogue Barres d’outils.
Cliquez sur la commande Compléments COM que vous avez ajoutée pour afficher la boîte de dialogue Compléments COM. La boîte de dialogue répertorie tous les compléments COM installés sur votre système, et les compléments COM actuellement chargés sont sélectionnés.

Les compléments COM peuvent également être chargés et déchargés via l’interface utilisateur Excel. Pour cela, procédez comme suit :

Cliquez sur le bouton Microsoft Office, puis sur Options Excel.
Cliquez sur Compléments.
Sous Gérer, cliquez sur AJOUTER COM, puis cliquez sur Accéder .

La boîte de dialogue Compléments COM répertorie tous les compléments COM installés sur l’ordinateur. Les compléments COM actuellement chargés sont sélectionnés.

Pour plus d’informations, consultez le site web Microsoft suivant :

Vue d’ensemble de la plateforme des compléments Office

Compléments Automation

Outre les compléments COM, Excel prend en charge les compléments Automation. Les compléments Automation s’appuient sur des compléments COM dans qui fonctionnent dans les compléments Automation peuvent être appelés à partir de formules dans des feuilles de calcul Excel. Les compléments COM doivent être des serveurs COM in-process qui prennent en charge l’interface IDTExtensibility2 ; Toutefois, les compléments Automation peuvent être des serveurs COM in-process ou out-of-process et l’implémentation d’IDTExtensibility2 est facultative.

Pour utiliser des fonctions à partir d’un complément Automation dans Excel, procédez comme suit :

Dans le menu Outils, cliquez sur Compléments.
Dans la boîte de dialogue Add-Ins, cliquez sur Automatisation. Dans la liste des serveurs COM inscrits, sélectionnez votre complément Automation, puis cliquez sur OK.
Le complément Automation s’affiche dans la boîte de dialogue Compléments. Cliquez sur OK pour fermer la boîte de dialogue Add-Ins.

Pour utiliser des fonctions à partir d’un complément Automation dans Excel 2007 et versions ultérieures, procédez comme suit :

Cliquez sur le bouton Microsoft Office, puis sur Options Excel.
Cliquez sur Compléments.
Sous Gérer, cliquez sur Compléments Excel, puis cliquez sur Accéder.
Dans la boîte de dialogue Compléments , cliquez sur Automation. Dans la liste des serveurs COM inscrits, cliquez sur votre complément Automation, puis sur OK.

Le complément Automation s’affiche dans la boîte de dialogue Compléments . Cliquez sur OK pour fermer la boîte de dialogue Compléments .

Lorsque vous ajoutez des ajouts à la liste dans la boîte de dialogue Add-Ins ou lorsque vous sélectionnez et désactivez les compléments dans la liste, Excel stocke vos modifications dans le Registre. Tout d’abord, Excel utilise le paramètre de Registre suivant pour déterminer si un complément Automation dans la liste des compléments est chargé ou non :

 Excel 2002
Key:            HKEY_CURRENT_USER\Software\Microsoft\Office\10.0\Excel\Options
String:         OPENx
Sample Value:   /A "ServerName.ClassName"

 Excel 2003
Key:            HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Excel\Options
String:         OPENx
Sample Value:   /A "ServerName.ClassName"
Excel 2007
Key:            HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Excel\Options
String:         OPENx
Sample Value:   /A "ServerName.ClassName"

Remarque : Modifiez le numéro de version d’Office en fonction de la version que vous utilisez.

Le commutateur /A utilisé dans la valeur de chaîne est nouveau dans Excel et est utilisé spécifiquement pour charger des compléments Automation. Tous les compléments Automation sont chargés à la demande ; aucun paramètre ne peut modifier le comportement de chargement d’un complément Automation.

Lorsqu’un complément Automation répertorié dans la boîte de dialogue Add-Ins est effacé, une sous-clé dont le nom est égal au ProgID du complément est créée dans la clé de Registre suivante :

HKEY_CURRENT_USER\Software\Microsoft\Office\10.0\Excel\Add-in Manager Excel 2003 :

HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Excel\Add-in Manager
HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Excel\Add-in Manager Ce paramètre de Registre garantit que les compléments Automation que vous avez ajoutés à la liste des compléments sont conservés dans la liste, même lorsque vous avez choisi de ne pas les charger.

Pour plus d’informations, consultez le site web Microsoft suivant :

Vue d’ensemble de la plateforme des compléments Office

Compléments Automation qui implémentent IDTExtensibility2

Comme mentionné précédemment, un complément Automation peut implémenter IDTExtensibility2, mais il n’est pas nécessaire pour qu’Excel puisse appeler les fonctions du complément à partir d’une feuille de calcul. Si vous avez besoin que votre complément Automation obtienne une référence au instance Excel, vous pouvez implémenter IDTExtensibility2 et utiliser le paramètre Application de OnConnection pour automatiser Excel.

Complément Automation qui implémente
IDTExtensibility2 peut être chargé dans l’interface utilisateur Excel via la boîte de dialogue COM Add-Ins et la boîte de dialogue Add-Ins. La section suivante décrit le comportement d’un complément Automation selon qu’il est chargé dans l’une de ces boîtes de dialogue ou dans les deux :

Chargé uniquement dans la boîte de dialogue Compléments.

Le complément est chargé à la demande. Les fonctions du complément peuvent être appelées à partir de formules dans une feuille de calcul.
Chargé uniquement dans la boîte de dialogue Compléments COM.

Le complément est chargé en tant que complément COM et son comportement de chargement est déterminé à partir des paramètres du Registre. Les fonctions du complément ne peuvent pas être appelées à partir de formules dans une feuille de calcul.
Chargé dans la boîte de dialogue Compléments COM et dans la boîte de dialogue Compléments.

Deux instances distinctes du complément sont chargées. Une instance est chargée en tant que complément COM et l’autre instance est chargée en tant que complément Automation. Le complément COM instance utilise le comportement de chargement indiqué dans le Registre ; le complément Automation instance se charge à la demande. Les deux instances fonctionnent indépendamment l’une de l’autre et ne partagent pas de variables globales.

Étant donné que les compléments Automation sont chargés à la demande, Excel peut tenter de charger le complément alors qu’il est en mode d’édition de cellule. Par conséquent, lorsque vous développez un complément Automation qui prend en charge IDTExtensibility2, vous devez veiller à ne pas faire quoi que ce soit qui tente de modifier l’état d’Excel pendant le chargement du complément. Pour plus d’informations, consultez l’article suivant dans la Base de connaissances Microsoft :

Compléments COM Excel et compléments Automation

Résumé

Informations supplémentaires