Procedura: creare pagine delle opzioni personalizzate

La finestra di dialogo Opzioni visualizza numerose pagine per parti diverse di Visual Studio.È possibile controllare le pagine di opzioni esistenti, come descritto in Controllo delle impostazioni relative alle opzioni, e creare pagine di opzioni personalizzate.È possibile utilizzare pagine personalizzate per consentire agli utenti di modificare le impostazioni per i componenti aggiuntivi o per altri programmi.

Per creare una pagina Opzioni personalizzata, non è necessario utilizzare un componente aggiuntivo perché la definizione della pagina viene archiviata in un file XML anziché nelle chiavi del Registro di sistema.Di conseguenza, è possibile creare pagine Opzioni accessibili nell'ambiente di sviluppo integrato (IDE, Integrated Development Environment) di Visual Studio e anche nell'IDE macro.

Nei passaggi seguenti viene illustrato come creare un controllo utente personalizzato che verrà utilizzato come pagina Opzioni personalizzata e modificare quindi un file con estensione addin per farvi riferimento.

[!NOTA]

È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma.Queste procedure sono state sviluppate con le Impostazioni generali per lo sviluppo attive.Per modificare le impostazioni, scegliere Importa/Esportaimpostazioni dal menu Strumenti.Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Per creare una pagina delle opzioni personalizzata

1. Creare un progetto di libreria di controlli Windows.Denominarlo ToolsOptionsLibrary.dll.

2. Aggiungere i controlli e le funzionalità desiderati.

   Questo controllo utente diventerà la pagina Opzioni personalizzata.Ridimensionare il controllo in modo da riempire l'area client della finestra di dialogo Opzioni.

3. Compilare il progetto.

   All'avvio di Visual Studio viene eseguita la ricerca di tutti i file con estensione addin condivisi; quelli presenti vengono caricati.La pagina Opzioni denominata Sicurezza macro/componenti aggiuntivi definisce un set di token per percorsi di file con estensione addin.Sono inclusi i token riportati di seguito:

   • %ALLUSERSPROFILE%

   • %APPDATA%

   • %USERPROFILE%

   • %VSAPPDATA%

   • %VSCOMMONAPPDATA%

   Quando in Visual Studio viene avviata la ricerca dei file con estensione addin, questi token vengono sostituiti con le stringhe di percorso seguenti:

   Token	Percorso
   %ALLUSERSPROFILE%	..\Documents and Settings\All Users\Dati applicazioni\Microsoft\MSEnvShared\Addins\
   %APPDATA%	..\Documents and Settings\nomeutente\Microsoft\MSEnvShared\Addins\
   %USERPROFILE%	..\Documents and Settings\nomeutente\Documenti\Visual Studio 2010\Addins\
   %VSAPPDATA%	..\Documents and Settings\nomeutente\Addins\
   %VSCOMMONAPPDATA%	..\Documents and Settings\All Users\Addins

   Per ulteriori informazioni sulle modalità di registrazione dei componenti aggiuntivi, vedere Sicurezza dei componenti aggiuntivi.

4. In una delle directory elencata precedentemente creare un file con estensione addin per fare riferimento alla nuova pagina Opzioni.

   È possibile utilizzare come modello il codice seguente:

   <?xml version="1.0" encoding="UTF-16" standalone="no"?>
   <Extensibility xmlns="https://schemas.microsoft.com/AutomationExtensibility">
       <HostApplication>
           <Name>Microsoft Visual Studio Macros</Name>
           <Version>10.0</Version>
       </HostApplication>
       <HostApplication>
           <Name>Microsoft Visual Studio</Name>
           <Version>10.0</Version>
       </HostApplication>
       <ToolsOptionsPage>
           <Category Name="Environment">
               <SubCategory Name="My Tools Options Page">
                   <Assembly><dll location></Assembly>
                   <FullClassName>ToolsOptionsLibrary.UserControl1
                   </FullClassName>
               </SubCategory>
           </Category>
       </ToolsOptionsPage>
   </Extensibility>
   

5. Nel tag <Assembly></Assembly> sostituire <dll location> con il percorso di ToolsOptionsLibrary.dll.

6. Modificare le impostazioni di <ToolsOptionsPage> (Nome categoria, Nome sottocategoria e così via) in modo da riflettere le specifiche del controllo utente.

   Se, ad esempio, il controllo utente venisse denominato "NewPage" e il progetto fosse "MyTOLib", il tag FullClassName sarebbe MyTOLib.NewPage.L'assembly si trova nel percorso della DLL delle opzioni.Il Nome categoria corrisponde al nodo nella finestra di dialogo Opzioni dove si desidera posizionare la pagina personalizzata, ad esempio Ambiente, Debug o Progetti.

   Se si specifica un nome che non esiste, viene creato un nodo con tale nome.La sottocategoria corrisponde al nome visualizzato sotto il nodo.Si noti che il numero massimo di livelli consentito è due.Non è possibile aggiungere un nodo di terzo livello.

7. Salvare il file come file di testo con estensione addin in una delle cartelle dei file di componente aggiuntivo descritte precedentemente.La directory predefinita è ..\Documents and Settings\nomeutente\Dati applicazioni\Microsoft\MSEnvShared\Addins\.

   Quando si avvia Visual Studio, viene eseguita la ricerca in questa directory delle definizioni della pagina Opzioni personalizzate e quelle individuate vengono quindi caricate.È possibile modificare o aggiungere directory di componenti aggiuntivi tramite la pagina Sicurezza macro/componenti aggiuntivi sotto il nodo Ambiente nella finestra di dialogo Opzioni.

8. Avviare Visual Studio e fare clic su Opzioni nel menu Strumenti.

   Viene visualizzata la nuova pagina Opzioni.

Vedere anche

Attività

Procedura: modificare le caratteristiche delle finestre

Concetti

Controllo delle impostazioni relative alle opzioni

Registrazione di un componente aggiuntivo

Grafico del modello a oggetti di automazione

Altre risorse

Creazione e controllo delle finestre di ambiente

Riferimenti su Extensibility e automazione