Comment : modifier l'icône par défaut d'un complément

Les compléments Visual Studio sont déconseillés dans Visual Studio 2013. Vous devriez mettre vos compléments à niveau vers des extensions VSPackage. Pour plus d'informations sur les mises à jour, consultez FAQ : conversion de compléments en extensions VSPackage.

Vous pouvez modifier l'icône associée à la commande de menu pour un complément créé à l'aide du type de projet de complément de Visual Studio. Pour rechercher le type de projet de complément, dans la boîte de dialogue Nouveau projet, développez Autres types de projets, puis cliquez sur Projets d'extensibilité.

Lorsque vous créez un complément à l'aide du type de projet de complément, l'Assistant Complément vous permet d'ajouter une interface utilisateur pour le complément en activant la case à cocher Souhaitez-vous créer une interface utilisateur de barre de commandes pour votre complément ?.

Le modèle crée une commande dans le menu Outils qui ouvre votre complément. Par défaut, une émoticône se trouve en regard de la commande. Vous pouvez modifier l'icône en utilisant l'une des méthodes suivantes :

• Remplacez le numéro d'index de l'icône (qui est 59 pour l'icône par défaut) par le numéro d'une autre icône dans l'assembly Microsoft.VisualStudio.CommandBars. L'assembly contient presque 3 000 icônes.

• Définissez une bitmap personnalisée, par exemple un logo de société, compilez-la dans une DLL satellite en tant que ressource, puis modifiez votre code de complément pour pointer vers la nouvelle bitmap.

La première méthode est plus rapide, mais vous pouvez uniquement utiliser les icônes de Microsoft.VisualStudio.CommandBars. La seconde méthode vous permet d'utiliser n'importe quelle icône.

Pour remplacer l'icône actuelle par une autre icône

1. Ouvrez une solution créée à l'aide du type de projet de complément.

2. Dans le fichier projet, dans la méthode OnConnection, recherchez la ligne suivante.

   command = commands.AddNamedCommand2(_addInInstance, _
     "MyAddin1", "MyAddin1",  _
     "Executes the command for MyAddin1", True, 59, Nothing, _
     CType(vsCommandStatus.vsCommandStatusSupported, _
      Integer) + 
      CType(vsCommandStatus.vsCommandStatusEnabled, _
      Integer), vsCommandStyle.vsCommandStylePictAndText, _
      vsCommandControlType.vsCommandControlTypeButton)
   

   Command command = commands.AddNamedCommand2(_addInInstance, 
   "MyAddin1", "MyAddin1", "Executes the command for MyAddin1", 
   true, 59, ref contextGUIDS, (int)vsCommandStatus.
   vsCommandStatusSupported+(int)vsCommandStatus.
   vsCommandStatusEnabled, (int)vsCommandStyle.
   vsCommandStylePictAndText, vsCommandControlType
   .vsCommandControlTypeButton);
   

   Remarquez le numéro 59 dans l'appel AddNamedCommand2. Il s'agit de l'index de l'icône actuelle. Pour la remplacer par une autre icône standard, modifiez ce numéro. Par exemple, pour transformer l'icône en une étoile rouge, remplacez 59 par 6743. Lorsque vous exécutez votre complément, la commande apparaît dans le menu Outils avec une icône représentant une étoile rouge.

   Pour plus d'informations sur la recherche de numéros d'ID pour les icônes standard, consultez Liste des faces des boutons de la barre de commandes pour Microsoft Office System sur le site Web MSDN.

3. Si vous ne pouvez pas trouver une icône appropriée dans la bibliothèque Microsoft.VisualStudio.CommandBars, vous pouvez utiliser une bitmap personnalisée. Compilez la bitmap dans une DLL satellite en tant que ressource. Pour plus d'informations, consultez Comment : afficher une icône personnalisée dans le bouton du complément. Après avoir créé la ressource de DLL satellite, pointez sur elle dans AddNamedCommand2.

Voir aussi

Tâches

Comment : contrôler des compléments avec le Gestionnaire de compléments

Comment : créer un complément

Procédure pas à pas : création d'un Assistant

Concepts

Inscription d'un complément

Graphique Modèle d'objet Automation

Autres ressources

Création de compléments et d'Assistants

Commandes et commutateurs Visual Studio