Postup: definovat vlastní položku sady nástrojů pro modelování

Článek
03/12/2013

Usnadňuje vytvoření prvku nebo skupiny prvků podle vzoru, který často používáte, můžete přidat nové nástroje na panelu nástrojů modelování diagramy v Visual Studio Ultimate.Můžete distribuovat tyto položky panelu nástrojů do jiných Visual Studio Ultimate uživatelů.

Vlastní nástroj vytvoří jeden nebo více nových prvků v diagramu.Nelze vytvořit připojení vlastní nástroje.

Například může vytvořit vlastní nástroj pro vytváření prvků jako jsou tyto:

Balíček je spojen s profilem .NET a třída se stereotypem .NET.
Dvojice tříd, které jsou propojeny pomocí přidružení představující vzoru pozorovatel.

Tuto metodu můžete použít k vytvoření prvku nástroje.To znamená, že můžete vytvořit nástroje, které přetáhnete z panelu nástrojů do diagramu.Nelze vytvořit nástroje Spojnice.

Definování vlastního modelovacího nástroje

Chcete-li definovat vlastní modelování nástroj

Vytvoření diagramu UML, který obsahuje prvek nebo skupiny prvků.
- Tyto prvky mohou mít vztahy mezi nimi a může mít pomocné prvky, jako jsou porty, atributy, operace a kolíků.
Uložte diagram pomocí názvu, který chcete dát nový nástroj.Na soubor nabídky, použití Uložit...As.
V programu Průzkumník Windows zkopírujte soubory dvou diagram do následující složky nebo všechny podsložky:

YourDocuments**\Visual Studio 2012\Architecture Tools\Custom Toolbox Items**
- Pokud již neexistuje, vytvořte tuto složku.Pravděpodobně budete muset vytvořit i Architecture Tools a Custom Toolbox Items.
- Zkopírujte oba soubory diagram, jeden s názvem, který končí "...diagram"a druhá s názvem, který končí"...diagram.layout"
- Můžete vytvořit libovolný počet vlastních nástrojů.Pomocí jednoho diagramu pro jednotlivé nástroje.
(Volitelné) Vytvoření .tbxinfo soubor, jak je popsáno v jak definovat vlastnosti vlastní nástrojea přidat ho do stejného adresáře.To umožňuje definovat ikonu panelu nástrojů, popis a tak dále.
- Jeden .tbxinfo souboru lze definovat několik nástrojů.Může odkazovat na diagramu soubory, které jsou v podsložkách.
Restartujte aplikaci Visual Studio.Další nástroje se objeví v panelu nástrojů pro příslušný typ diagramu.

Co je nástroj pro vlastní replikuje

Vlastní nástroj replikuje většinu funkcí diagram zdrojů:

Názvy.Při vytvoření položky z panelu nástrojů číslo je přidán na konec názvu, pokud je nezbytné zamezit duplicitě názvů ve stejném oboru názvů.
Barvy, velikosti a tvary
Stereotypy a balíček profily
Hodnoty vlastností, jako je abstraktní.
Propojených pracovních položek
Násobnosti a další vlastnosti vztahů
Relativní umístění obrazců.

Vlastní nástroje, nebudou zachovány následující funkce:

Jednoduché tvary.Jsou obrazce, které nesouvisejí s prvky modelu, můžete nakreslit na některé druhy diagramů.
Směrování spojnice.Je-li ručně směrování spojnice TNG postupu nebudou zachovány při použití vašeho nástroje.Pozice některé vnořené tvary, jako jsou přístavy, nebudou zachovány vzhledem k jejich vlastníků.

Definování vlastností vlastní nástroje

Informace o panelu nástrojů (.tbxinfo) souboru umožňuje určit název panelu nástrojů, ikony, popis, karta a Nápověda klíčové slovo pro jeden nebo více vlastních nástrojů.Jej pojmenujte, jako například MyTools.tbxinfo.

Obecná forma soubor vypadá takto:

<?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>

Hodnotu každé položky může být buď:

Jak je znázorněno v příkladu <bmp fileName="…"/> pro ikonu panelu nástrojů a <value>string</value> pro ostatní zboží.

-nebo-

<resource fileName="Resources.dll"

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

V tomto případě zadáte zkompilované sestavení, ve kterém již byly zkompilovány řetězcové hodnoty jako prostředky.

Přidat <customToolboxItem> uzlu pro každou položku panelu nástrojů můžete definovat.

Uzly v .tbxinfo souboru jsou následující.Výchozí hodnota pro každý uzel není k dispozici.

Název uzlu	Definuje
displayName	Název položky panelu nástrojů.
tabName	Kartu panelu nástrojů, ve kterém by se měl zobrazit položky.Můžete zadat název běžné karty pro tento typ diagramu nebo zvláštní jméno.
Obrázek	Umístění rastrového obrázku (.bmp) souboru, který musí mít výšku a šířku 16 a barevnou hloubku 24 bitů.
f1Keyword	Klíčové slovo, které najde téma nápovědy.
Popis tlačítka	Popis pro tento nástroj.

Můžete upravit soubor rastrového obrázku v aplikaci Visual Studio a nastavit jeho výšku a šířku 16 v okně Vlastnosti.

[!POZNÁMKA]

Pokud spustit pomocí souboru .tbxinfo po experimentování s použitím souborů diagram na své vlastní, můžete zjistit, že panel nástrojů obsahuje na staré a nové verze položka panelu nástrojů.To může dojít, pokud název souboru s diagramem chybně zadaný v souboru .tbxinfo.V tomto případě z nabídky panelu zvolte Obnovit panel nástrojů.Položky vlastních nástrojů zmizí.Restartujte aplikaci Visual Studio a zobrazí správné vlastní položky.

Jak distribuovat položky panelu nástrojů v rozšíření aplikace Visual Studio

Můžete distribuovat položky panelu nástrojů do jiných Visual Studio uživatelům podle jejich balení do Visual Studio rozšíření (VSIX).Příkazy, profilů a dalších rozšíření lze zabalit do stejného souboru VSIX. Další informace naleznete v tématu Nasazení Visual Studio Extensions.

Obvyklý způsob vytvoření rozšíření aplikace Visual Studio je pomocí šablony projektu VSIX.Chcete-li to provést, musíte mít nainstalovaný Visual Studio SDK.

Chcete-li přidat položku sady nástrojů pro rozšíření aplikace Visual Studio

Vytvořit a otestovat vlastní nástroje pro jeden nebo více.
Vytvořte soubor .tbxinfo , které odkazuje nástroje.
Otevřte existující projekt rozšíření aplikace Visual Studio.

-nebo-

Definujte nové rozšíření projektu aplikace Visual Studio.
1. V nabídce Soubor zvolte položku Nový, Projekt.
2. V Nový projekt dialogovém okně vyberte v seznamu Nainstalované šablony, zvolte Visual C#, rozšíření, Projekt VSIX.
Vaše definice nástrojů přidáte do projektu.Zahrnout .tbxinfo souborů, souborů diagram, rastrové soubory a všechny zdrojové soubory a ujistěte se, že jsou součástí souboru VSIX.
- V Průzkumníku řešení vyberte v místní nabídce Projekt VSIX Přidat, Existující položku.V dialogovém okně nastavit objekty typu: všechny soubory.Vyhledejte soubory, vyberte je všechny a pak zvolte Přidat.
  
  [!POZNÁMKA]
  
  V tomto projektu nelze otevřít diagram soubory v editoru modelů.
Nastavte následující vlastnosti všech souborů, které jste právě přidali.Můžete nastavit jejich vlastnosti současně výběrem v Průzkumníku řešení.Dejte pozor, abyste měnit vlastnosti jiných souborů v projektu.

Kopírovat do výstupního adresáře = Vždy kopírovat

Akce sestavení = obsahu

Zahrnout do souboru VSIX = PRAVDA
Otevřete source.extension.vsixmanifest.Otevře se v editoru manifestu rozšíření.
Podle Metadata, přidat popis vlastní nástroje.

Podle majetku, zvolte Nový a nastavit v dialogovém okně pole takto:
- Typ = vlastní typ rozšíření
- Typ =Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems
  
  [!POZNÁMKA]
  
  To je jedna z možností v rozevíracím seznamu.Je nutné zadat pomocí klávesnice.
- Zdroj = souboru na filesystem.
- Cesta = vaše .tbxinfo soubor, napříkladMyTools.tbxinfo
Projekt sestavte.
Chcete-li ověřit, zda funguje rozšíření, stiskněte klávesu F5.Experimentální instanci aplikace Visual Studio spustí.

V experimentální instanci vytvořte nebo otevřete diagram UML odpovídající typu.Ověřte, že nový nástroj se zobrazí v panelu nástrojů a jestli vytváří prvky správně.
Chcete-li získat soubor VSIX pro nasazení: v programu Průzkumník Windows otevřete složku .\bin\Debug nebo .\bin\Release k nalezení .vsix souboru.Jedná se Visual Studio příponu souboru.Může být v počítači nainstalována a také odeslat jiným uživatelům aplikace Visual Studio.

Chcete-li nainstalovat vlastní nástroje z rozšíření aplikace Visual Studio

Otevřít .vsix souboru v Průzkumníkovi Windows nebo v aplikaci Visual Studio.
Zvolte nainstalovat v dialogovém okně, které se zobrazí.
Chcete-li odinstalovat nebo dočasně zakažte rozšíření, otevřete Extension Manager z Nástroje nabídky.

Lokalizace

Můžete vytvořit rozšíření, které při instalaci v jiném počítači, zobrazí nástroj názvy a popisy v jazyce cílovém počítači.

Chcete-li poskytnout verze nástroje ve více jazycích

Vytvořte projekt rozšíření Visual Studia, který obsahuje jeden nebo více vlastních nástrojů.

V .tbxinfo soubor, použijte metodu soubor prostředků definovat nástroje displayName, panel nástrojů tabNamea popis.Vytvořte zdrojový soubor, ve kterém jsou definovány tyto řetězce a kompilovat do sestavení naleznete v souboru tbxinfo.
Vytvořte další sestavení, které obsahují soubory prostředků s řetězci v jiných jazycích.
Každé další sestavení umístíte do složky, jejíž název je kód jazyka pro jazyk.Například francouzská verze sestavení umístit do složky s názvem fr.
Pokud použijete kód neutrální jazykové verze, obvykle dvě písmena, nikoli konkrétní jazykovou verzi, jako je například fr-CA.Další informace o kódech jazykovou verzi, naleznete v CultureInfo.GetCultures metoda, který obsahuje úplný seznam kódů jazykových verzí.
Sestavení rozšíření Visual Studia a distribuovat ji.
Při rozšíření je nainstalována v jiném počítači, verze souboru prostředků pro místní jazykovou verzi uživatele automaticky načten.Pokud jste nezadali verze pro jazykovou verzi uživatele, bude použit výchozí prostředky.

Tuto metodu nelze použít k instalaci různých verzí prototypu diagramu.Názvy prvků a spojnice bude stejné v každé instalaci.

Jiné operace nástrojů

Obvykle v Visual Studio, v panelu nástrojů můžete přizpůsobit přejmenováním nástroje, jejich přesunutí do karty různých nástrojů a jejich odstraněním. Ale tyto změny nejsou zachovány pro modelování vlastní nástroje, vytvořené s postupy, které jsou popsány v tomto tématu.Po restartování je Visual Studio, vlastní nástroje se znovu zobrazí jejich definované názvy a umístění panelu nástrojů.

Kromě toho vlastní nástroje zmizí, pokud provádíte Obnovit panel nástrojů příkaz.Však bude znovu po restartování Visual Studio.