Procedura: definire un elemento personalizzato della Casella degli strumenti di modellazione

Per facilitare la creazione di un elemento o di un gruppo di elementi in base a un modello utilizzato di frequente, in Visual Studio Ultimate è possibile aggiungere nuovi strumenti alla casella degli strumenti dei diagrammi di modellazione.È possibile distribuire questi elementi della casella degli strumenti ad altri utenti di Visual Studio Ultimate.

Uno strumento personalizzato viene creato uno o più i nuovi elementi in un diagramma.Non è possibile creare strumenti personalizzati della connessione.

Ad esempio, è possibile utilizzare uno strumento personalizzato per creare elementi seguenti:

• Un pacchetto collegato al profilo .NET e una classe con lo stereotipo .NET.

• Una coppia di classi collegate da un'associazione per rappresentare il modello Observer.

È possibile utilizzare questo metodo per creare strumenti dell'elemento,ovvero è possibile creare strumenti da trascinare dalla casella degli strumenti in un diagramma.Non è possibile creare strumenti del connettore.

Definizione di uno strumento di modellazione personalizzato

Per definire uno strumento di modellazione personalizzato

1. Creare un diagramma UML che contenga un elemento o un gruppo di elementi.

   • Questi elementi possono presentare relazioni tra loro e possono contenere elementi sussidiari quali porte, attributi, operazioni o pin.

2. Salvare il diagramma con il nome da assegnare al nuovo strumento.Scegliere dal menu File, utilizzare Salva con nome.

3. Utilizzare Esplora risorse per copiare i due file del diagramma nella cartella seguente o in qualsiasi sottocartella:

   YourDocuments**\Visual Studio 2012\Architecture Tools\Custom Toolbox Items**

   • Creare la cartella, se non esiste già.Potrebbe essere necessario creare sia Architecture Tools sia Custom Toolbox Items.

   • Copiare entrambi i file del diagramma, uno con il nome che termina con "...diagram" e l'altro con il nome che termina con "...diagram.layout".

   • È possibile creare tutti gli strumenti personalizzati che si desidera.Utilizzare un diagramma per ogni strumento.

4. (Facoltativo) Creare un file .tbxinfo come descritto in Come definire le proprietà degli strumenti personalizzati e aggiungerlo alla stessa directory.Questo file consente di definire un'icona della casella degli strumenti, una descrizione comando e così via.

   • È possibile utilizzare un singolo file .tbxinfo per definire diversi strumenti.Può fare riferimento ai file del diagramma presenti nelle sottocartelle.

5. Riavviare Visual Studio.Lo strumento aggiuntivo verrà visualizzato nella casella degli strumenti per il tipo di diagramma appropriato.

Elementi replicati dallo strumento personalizzato

Uno strumento personalizzato replicherà la maggior parte delle funzionalità del diagramma di origine:

• Nomi.Quando un elemento viene creato dalla casella degli strumenti, se necessario viene aggiunto un numero alla fine del nome per evitare nomi duplicati nello stesso spazio dei nomi.

• Colori, dimensioni e forme

• Stereotipi e profili di pacchetto

• Valori delle proprietà come Is Abstract

• Elementi di lavoro collegati

• Molteplicità e altre proprietà di relazioni

• Posizioni relative delle forme.

Le funzionalità seguenti non verranno mantenute in uno strumento personalizzato:

• Forme semplici.Si tratta di forme non correlate a elementi del modello che è possibile disegnare in alcuni tipi di diagrammi.

• Routing del connettore.Se si esegue il routing dei connettori manualmente, il routing non verrà mantenuto quando lo strumento viene utilizzato.Le posizioni di alcune forme annidate, come le Porte, non vengono mantenute relativamente ai proprietari.

Come definire le proprietà degli strumenti personalizzati

Un file informazioni della casella degli strumenti (.tbxinfo) consente di specificare il nome della casella degli strumenti, l'icona, la descrizione comando, la scheda e la parola chiave della guida per uno o più strumenti personalizzati.Assegnare ad esso qualsiasi nome, ad esempio MyTools.tbxinfo.

Il formato generale del file è come segue:

<?xml version="1.0" encoding="utf-8" ?>
<customToolboxItems xmlns="https://schemas.microsoft.com/visualstudio/2010/ArchitectureTools/CustomToolboxItems">
  <customToolboxItem fileName="MyObserverTool.classdiagram">
    <displayName>
       <value>Observer Pattern</value>
    </displayName>
    <tabName>
       <value>UML Class Diagram</value>
    </tabName>
    <image><bmp fileName="ObserverPatternIcon.bmp"/></image>
    <f1Keyword>
      <value>ObserverPatternHelp</value>
    </f1Keyword>
    <tooltip>
       <value>Create a pair of classes</value>
    </tooltip>
  </customToolboxItem>
</customToolboxItems>

Il valore di ogni elemento può essere:

• Come illustrato nell'esempio, <bmp fileName="…"/> per l'icona della casella degli strumenti e <value>string</value> per gli altri elementi.

- oppure -

• <resource fileName="Resources.dll"

  baseName="Observer.resources" id="Observer.tabname" />

  In tal caso, fornire un assembly compilato in cui i valori stringa sono stati compilati come risorse.

Aggiungere un nodo <customToolboxItem> per ogni elemento della casella degli strumenti che si desidera definire.

I nodi nel file .tbxinfo sono come illustrato di seguito.Esiste un valore predefinito per ogni nodo.

È possibile modificare il file bitmap in Visual Studio e impostare l'altezza e larghezza su 16 nella finestra Proprietà.

[!NOTA]

Se si inizia a utilizzare un file con estensione tbxinfo dopo avere sperimentato l'utilizzo dei soli file del diagramma, è possibile che nella casella degli strumenti siano presenti sia la versione vecchia che quella nuova di un elemento della casella degli strumenti.Ciò può verificarsi anche se il nome del file del diagramma è stato digitato in modo errato nel file con estensione tbxinfo.In questo caso, nel menu di scelta rapida della casella degli strumenti scegliere Reimposta Casella degli strumenti.Gli elementi della casella degli strumenti personalizzati scompariranno.Riavviare Visual Studio per visualizzare gli elementi personalizzati corretti.

Come distribuire gli elementi della casella degli strumenti in un pacchetto Visual Studio Extension

È possibile distribuire elementi della casella degli strumenti ad altri utenti di Visual Studio comprimendoli in un pacchetto Visual Studio Extension (VSIX).È possibile comprimere i controlli, profili e altre estensioni nello stesso file VSIX. Per ulteriori informazioni, vedere Distribuzione delle estensioni di Visual Studio (la pagina potrebbe essere in inglese).

Il metodo consueto per compilare un'estensione di Visual Studio è utilizzare il modello di progetto VSIX.A tale scopo, è necessario che sia installato Visual Studio SDK.

Per aggiungere un elemento della casella degli strumenti in un'estensione di Visual Studio

1. Creare e testare uno o più strumenti personalizzati.

2. Creare un file con estensione tbxinfo che faccia riferimento agli strumenti.

3. Aprire un progetto Visual Studio Extension esistente.

   - oppure -

   Definire un nuovo progetto Visual Studio Extension.

   1. Dal menu File, scegliere Nuovo, Progetto.

   2. Nella finestra di dialogo Nuovo progetto, in Modelli installati, scegliere Visual C#, Extensibility, Progetto VSIX.

4. Aggiungere le definizioni della casella degli strumenti al progetto.Includere il file .tbxinfo, i file del diagramma, i file bitmap ed eventuali file di risorse, quindi verificare che siano inclusi nell'estensione VSIX.

   • In Esplora soluzioni, scegliere dal menu di scelta rapida del progetto VSIX, scegliere Aggiungi, Elemento esistente.Nella finestra di dialogo impostare Tipo oggetto: Tutti i file.Individuare i file, selezionarli tutti quindi scegliere Aggiungi.

     [!NOTA]

     In questo progetto non è possibile aprire i file del diagramma nell'editor dei modelli.

5. Impostare le proprietà seguenti di tutti i file appena aggiunti.È possibile impostare le proprietà contemporaneamente selezionandole in Esplora soluzioni.Prestare attenzione a non modificare le proprietà degli altri file nel progetto.

   Copia nella directory di output = Copia sempre

   Operazione di compilazione = Contenuto

   Includi in VSIX = true

6. Aprire source.extension.vsixmanifest.Il file verrà visualizzato nell'editor del manifesto dell'estensione.

7. In Metadati, aggiungere una descrizione degli strumenti personalizzati.

   In Risorse, scegliere Nuovo quindi impostare i campi nella finestra di dialogo come segue:

   • Tipo = Tipo di estensione predefinito

   • Tipo = Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems

     [!NOTA]

     Ciò non è una delle opzioni nell'elenco a discesa.È necessario spostarlo utilizzando la tastiera.

   • Database di origine = File in filesystem.

   • Percorso = il file di .tbxinfo, ad esempio MyTools.tbxinfo

8. Compilare il progetto.

9. Per verificare il corretto funzionamento di estensione, premere F5.L'istanza sperimentale dell'avvio di Visual Studio.

   Nell'istanza sperimentale, creare o aprire un diagramma UML del tipo appropriato.Verificare che il nuovo strumento visualizzato nella casella degli strumenti e creare gli elementi correttamente.

10. Per ottenere un file VSIX per la distribuzione: in Esplora risorse, aprire la cartella .\bin\Debug o .\bin\Release per individuare il file di .vsix.Si tratta di un file di Visual Studio Extension.Può essere installato nel computer ed essere inoltre inviato agli altri utenti di Visual Studio.

Per installare gli strumenti personalizzati da un pacchetto Visual Studio Extension

1. Aprire il file di .vsix in Esplora risorse o in Visual Studio.

2. Scegliere Installa nella finestra di dialogo.

3. Per disinstallare o disabilitare temporaneamente l'estensione, aprire Gestione estensioni dal menu Strumenti.

Localizzazione

È possibile creare un'estensione in modo tale che, quando viene installata in un altro computer, i nomi e le descrizioni comando dello strumento vengano visualizzati nella lingua del computer di destinazione.

Per fornire versioni dello strumento in più lingue

1. Creare un progetto Visual Studio Extension che contenga uno o più strumenti personalizzati.

   Nel file .tbxinfo utilizzare il metodo del file di risorse per definire il valore displayName, la casella degli strumenti tabName e la descrizione comando dello strumento.Creare un file di risorse in cui vengono definite tali stringhe, compilarlo in un assembly e farvi riferimento dal file con estensione tbxinfo.

2. Creare assembly aggiuntivi contenenti file di risorse con stringhe in altre lingue.

3. Posizionare ogni assembly aggiuntivo in una cartella il cui nome sia il codice delle impostazioni cultura per la lingua.Inserire, ad esempio, una versione in lingua francese dell'assembly in una cartella denominata fr.

4. È consigliabile utilizzare un codice indipendente dalle impostazioni cultura, in genere costituito da due lettere, non il codice delle impostazioni cultura specifiche come ad esempio fr-CA.Per ulteriori informazioni sui codici delle impostazioni cultura, vedere Metodo CultureInfo.GetCultures (la pagina potrebbe essere in inglese), in cui viene fornito un elenco completo di codici delle impostazioni cultura.

5. Compilare il progetto Visual Studio Extension e distribuirlo.

6. Quando l'estensione viene installata in un altro computer, verrà automaticamente caricata la versione del file di risorse per le impostazioni cultura locali dell'utente.Se non è stata fornita una versione per le impostazioni cultura dell'utente, verranno utilizzate le risorse predefinite.

Non è possibile utilizzare questo metodo per installare versioni diverse del diagramma prototipo.I nomi degli elementi e dei connettori saranno gli stessi in ogni installazione.

Altre operazioni della casella degli strumenti

Normalmente, in Visual Studio, è possibile personalizzare la casella degli strumenti rinominando gli strumenti, spostandoli in altre schede della casella degli strumenti ed eliminandoli. Tali modifiche non vengono mantenuti per gli strumenti di modellazione personalizzati creati con le procedure descritte in questo argomento.Quando si riavvia Visual Studio, gli strumenti personalizzati verranno visualizzati nuovamente con i nomi e i percorsi della casella degli strumenti definiti.

Inoltre, gli strumenti personalizzati verranno nascosti se si esegue il comando Reimposta Casella degli strumenti.Verranno però visualizzati nuovamente quando si riavvia Visual Studio.

Vedere anche

Concetti

Estensione di modelli e diagrammi UML

Procedura: definire un profilo per estendere UML

Procedura: definire un comando di menu in un diagramma di modellazione

Procedura: definire vincoli di convalida per i modelli UML