Procedura: modificare l'icona predefinita per un componente aggiuntivo

È possibile modificare l'icona associata al comando di menu di un componente aggiuntivo creato utilizzando il tipo di progetto Componente aggiuntivo Visual Studio.Per individuare il tipo di progetto Componente aggiuntivo, nella finestra di dialogo Nuovo progetto espandere Altri tipi di progetto, quindi fare clic su Progetti Extensibility.

Quando si crea un componente aggiuntivo utilizzando il tipo di progetto Componente aggiuntivo, la Creazione guidata componente aggiuntivo consente di aggiungere un'interfaccia utente per il componente aggiuntivo selezionando la casella di controllo Creare un'interfaccia utente con barra dei comandi per il componente aggiuntivo?.

Tramite il modello viene creato un comando nel menu Strumenti, che consente di aprire il componente aggiuntivo.Per impostazione predefinita, accanto al comando viene visualizzata l'icona di uno smile.È possibile modificare l'icona utilizzando uno dei metodi seguenti:

• Modificare il numero di indice dell'icona (59 per l'icona predefinita) scegliendo il numero di un'altra icona nell'assembly Microsoft.VisualStudio.CommandBars.L'assembly contiene quasi 3.000 icone.

• Definire una bitmap personalizzata, ad esempio un logo aziendale, compilarla come risorsa in una DLL satellite, quindi modificare il codice del componente aggiuntivo in modo che punti alla nuova bitmap.

Il primo metodo è più veloce, ma consente di utilizzare solo le icone incluse in Microsoft.VisualStudio.CommandBars.Il secondo metodo consente di utilizzare qualsiasi icona.

[!NOTA]

Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Per modificare l'icona corrente scegliendo un'altra icona

1. Aprire una soluzione creata utilizzando il tipo di progetto Componente aggiuntivo.

2. Nel file di progetto, individuare la riga seguente nel metodo OnConnection.

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

   Si noti il numero 59 nella chiamata a AddNamedCommand2.Si tratta dell'indice dell'icona corrente.Per impostare un'altra icona standard, cambiare questo numero.Per impostare ad esempio l'icona su una stella rossa, modificare da 59 a 6743.Quando si esegue il componente aggiuntivo, il comando viene visualizzato nel menu Strumenti insieme a un'icona con una stella rossa.

   Per ulteriori informazioni su come individuare i numeri di ID per le icone standard, vedere Elenco delle superfici pulsanti nella barra dei comandi per Microsoft Office System nel sito Web MSDN (la pagina potrebbe essere in inglese).

3. Se non è possibile trovare un'icona appropriata nella libreria Microsoft.VisualStudio.CommandBars, è possibile utilizzare una bitmap personalizzata.Compilare la bitmap come risorsa in una DLL satellite.Per ulteriori informazioni, vedere Procedura: visualizzare un'icona personalizzata sul pulsante del componente aggiuntivo.Dopo avere creato la risorsa DLL satellite, farvi riferimento da AddNamedCommand2.

Vedere anche

Attività

Procedura: controllare i componenti aggiuntivi tramite Gestione componenti aggiuntivi

Procedura: creare un componente aggiuntivo

Procedura dettagliata: creazione di una procedura guidata

Riferimenti

Comandi e opzioni di Visual Studio

Concetti

Registrazione di un componente aggiuntivo

Grafico del modello a oggetti di automazione

Altre risorse

Creazione di componenti aggiuntivi e di procedure guidate