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

Article
08/10/2011

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.

Notes

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

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

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

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 (page éventuellement en anglais) sur le site Web MSDN.

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

Partager via

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

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

Voir aussi

Tâches

Référence

Concepts

Autres ressources

Ressources supplémentaires