Cómo: Cambiar el icono predeterminado de un complemento

Actualización: noviembre 2007

Puede cambiar el icono predeterminado que Visual Studio asocia con los elementos del menú para un complemento creado usando el tipo de proyecto Complemento de Visual Studio.

Cuando cree un complemento con el tipo de proyecto Complemento de Visual Studio, tiene la opción de crear una interfaz de usuario para el complemento; para ello, active la casilla "¿Desea crear la interfaz de usuario de barra de comandos para el complemento?". Para encontrar el tipo de proyecto Complemento de Visual Studio, expanda Otros tipos de proyectos y, a continuación, haga clic en Proyectos de extensibilidad en el cuadro de diálogo Nuevo proyecto.

La plantilla crea un elemento del menú Herramientas que hace que el complemento cargue cuando un usuario hace clic en él. El elemento de menú tiene un icono predeterminado de cara sonriente junto al comando, que puede cambiar utilizando uno de estos métodos.

Un método consiste en cambiar simplemente el número de índice de icono predeterminado (que es el 59) por el número de otro icono estándar del ensamblado Microsoft.VisualStudio.CommandBars, que contiene cerca de 3.000 iconos. Una segunda opción es definir un mapa de bits personalizado, tal como un logotipo de empresa o un icono personalizado, colocarlo como un recurso en una DLL satélite y, a continuación, cambiar el código del complemento para que apunte a ese nuevo mapa de bits. El primer método es más rápido y más fácil, pero se limita a los iconos de Microsoft.VisualStudio.CommandBars. El segundo implica algo más de trabajo, pero puede utilizar el icono exacto que desee.

Nota:

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de la configuración activa o la edición. Estos procedimientos se han desarrollado con la Configuración de desarrollo general activa. Para cambiar la configuración, elija la opción Importar y Exportarconfiguraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Para cambiar el icono predeterminado por otro icono estándar

1. Abra una solución creada por el Asistente para complementos.

2. En el evento OnConnection, busque la línea siguiente:

   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);
   

   Observe el número, 59, en la llamada AddNamedCommand2. Éste es el índice del icono predeterminado, una cara sonriente. Para cambiar a un icono estándar diferente, cambie este número. Por ejemplo, para cambiar el icono a una estrella roja, cambie 59 por 6743. Cuando ejecute el complemento, el comando aparecerá en el menú Herramientas junto a un icono de estrella roja.

   Para obtener una lista completa de iconos estándar disponibles, vea Finding Face ID Numbers for Your Microsoft Office 97 Toolbars. Este artículo de MSDN Library contiene una pequeña aplicación que permite ver todos los iconos y obtener sus números de ID, para poder elegir el icono que se desee.

   Si no encuentra un icono adecuado en la biblioteca de Microsoft.VisualStudio.CommandBars, puede utilizar un mapa de bits personalizado para el icono de comando del complemento. El mapa de bits se contiene como recurso en un archivo DLL satélite. Para obtener más información, vea Cómo: Mostrar un icono personalizado en un botón de complemento. Después de crear el recurso DLL satélite, apunte a continuación AddNamedCommand2 al icono personalizado.

   Nota:
   El sitio Visual Studio Automation Samples incluye un proyecto de ejemplo que se puede descargar donde se demuestra cómo hacer esto en Visual Basic y Visual C#. Haga clic en el vínculo "Custom Bitmap Add-in".

Vea también

Tareas

Cómo: Controlar complementos con el Administrador de complementos

Cómo: Crear un complemento

Tutorial: Crear un asistente

Conceptos

Registro de complementos

Gráfico del modelo de objetos de automatización

Referencia

Modificadores y comandos de Visual Studio

Otros recursos

Crear complementos y asistentes