Procedura: modificare l'icona predefinita per un componente aggiuntivo

I componenti aggiuntivi di Visual Studio sono deprecati in Visual Studio 2013. Si consiglia di effettuare l'aggiornamento dei componenti aggiuntivi alle estensioni di VSPackage. Per ulteriori informazioni sull'aggiornamento, consultare Domande frequenti: conversione di componenti aggiuntivi in VSPackage Extensions.

È 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

Nomi o percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni vedere Personalizzazione delle impostazioni di sviluppo in 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 ID per le icone standard, consultare Elencare le 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

Concetti

Registrazione di un componente aggiuntivo

Grafico del modello a oggetti di automazione

Altre risorse

Creazione di componenti aggiuntivi e di procedure guidate

Comandi e opzioni di Visual Studio