Jak: Definiowanie niestandardowej modelowania element przybornika

Artykuł
03/12/2013

Aby ułatwić tworzenie elementu lub grupy elementów według schematu, który jest często używane, można dodać nowe narzędzia do przybornika modelowania diagramów w Visual Studio Ultimate.Można rozpowszechniać te elementy do przybornika do innych Visual Studio Ultimate użytkowników.

Niestandardowe narzędzie tworzy jeden lub więcej nowych elementów na diagramie.Nie można tworzyć narzędzia niestandardowe połączeń.

Na przykład można by niestandardowe narzędzie do tworzenia elementów, takich jak te:

Pakiet związane z profilem .NET i klasa ze stereotypem .NET.
Para klas związanych z przez stowarzyszenie do reprezentowania wzorzec.

Ta metoda służy do tworzenia element narzędzia.Oznacza to można utworzyć narzędzia, które zostają przeciągnięte z przybornika na diagramie.Nie można utworzyć narzędzia Łącznik.

Definiowanie niestandardowego narzędzia do modelowania

Aby zdefiniować narzędzia niestandardowe modelowania

Tworzenie diagramu UML, który zawiera element lub grupę elementów.
- Elementy te mogą mieć relacje między nimi i może mieć uzupełniającej elementów, takich jak porty, atrybuty, operacje lub osobiste numery identyfikacyjne.
Zapisz diagram przy użyciu nazwy, którą chcesz nadać nowe narzędzie.Na pliku menu, użyj zapisać...As.
W Eksploratorze Windows skopiuj pliki dwóch diagramu do następującego folderu lub podfolder:

YourDocuments**\Visual Studio 2012\Architecture Tools\Custom Toolbox Items**
- Jeśli jeszcze nie istnieje, utwórz ten folder.Być może trzeba utworzyć zarówno Architecture Tools i Custom Toolbox Items.
- Skopiuj pliki obu diagramu, jeden z nazwą, która kończy "...diagram", a drugi z nazwą, która kończy się"...diagram.layout"
- Można wprowadzić dowolną liczbę narzędzi niestandardowych, jak chcesz.Użyj jeden diagram dla każdego narzędzia.
(Opcjonalnie) Tworzenie .tbxinfo plik opisane w jak zdefiniować właściwości niestandardowe narzędziai dodać go do tego samego katalogu.Dzięki temu można zdefiniować ikonę przybornika, wskazówka do narzędzia i tak dalej.
- Jeden .tbxinfo pliku mogą być używane do określania kilka narzędzi.Może się odnosić do diagramów pliki, które znajdują się w podfolderach.
Uruchom ponownie program Visual Studio.Dodatkowe narzędzia pojawi się w przyborniku na odpowiedni typ diagramu.

Co zreplikuje narzędzie niestandardowe

Niestandardowe narzędzie zreplikuje większość funkcji diagram Yródłowy:

Nazwy.Gdy towar zostanie utworzony z przybornika, numer jest dodawany na końcu nazwy, jeśli jest to konieczne, aby uniknąć takich samych nazwach w tej samej przestrzeni nazw.
Kolory, rozmiary i kształty
Stereotypy i profilów pakietu
Wartości właściwości, takie jak jest abstrakcyjny
Połączonych elementów pracy
Liczebność punktów i innych właściwości relacji
Względne położenie kształtów.

Następujące funkcje nie zostaną zachowane w narzędziu niestandardowe:

Proste kształty.Są to kształty, które nie są związane z elementami modelu, że można wyciągnąć na niektóre rodzaje diagramów.
Trasowania łączników.Jeśli ręcznie trasowanie łączników marszruty nie zostaną zachowane podczas swoje narzędzia.Pozycje kilka zagnieżdżonych kształtów, takich jak porty, nie są zachowywane w stosunku do ich właścicieli.

Jak zdefiniować właściwości niestandardowe narzędzia

Informacji przybornika (.tbxinfo) plik pozwala określić nazwy przybornik, ikony, wskazówka do narzędzia, kartę, a pomoc słowa kluczowego dla jednego lub więcej niestandardowych narzędzi.Nadać dowolną nazwę, takich jak MyTools.tbxinfo.

Powszechną formą pliku jest następująca:

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

Wartość każdego elementu może być:

Jak pokazano w przykładzie, <bmp fileName="…"/> na ikonę przybornika i <value>string</value> dla innych elementów.

- lub -

<resource fileName="Resources.dll"

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

W takim przypadku podanych skompilowanym zestawie, w którym zostały skompilowane wartości ciągu jako zasoby.

Dodać <customToolboxItem> węzła dla każdego elementu przybornika, którego chcesz zdefiniować.

Węzły w .tbxinfo pliku są następujące.Ma wartości domyślnej, dla każdego węzła.

Nazwa węzła	Definiuje
displayName	Nazwa element przybornika.
tabName	Karta przybornika, w którym powinien pojawić się element.Można określić nazwę regularnych karty dla tego typu diagramu lub osobnej nazwy.
Obraz	Lokalizacja mapy bitowej (.bmp) pliku, który muszą mieć wysokość i szerokość 16 i głębi kolorów 24 bitów.
f1Keyword	Słowo kluczowe, który lokalizuje tematu Pomocy.
Wskazówka do narzędzia	Etykietka narzędzia dla tego narzędzia.

Można edytować pliku mapy bitowej w programie Visual Studio i ustawić jej wysokości i szerokości do 16 w oknie dialogowym właściwości.

[!UWAGA]

Jeśli zaczniesz używać pliku .tbxinfo za najdogodniejszy diagramów pliki na własną, może się okazać, że Przybornik zawiera stare i nowe wersje element przybornika.Może to także wystąpić, jeśli nazwa pliku diagram został wpisany z błędem w pliku .tbxinfo.W takim przypadku w menu skrótów, przybornika wybierz Zresetować przybornik.Elementy do przybornika niestandardowe zniknie.Ponownie uruchom Visual Studio, a pojawią się odpowiednie elementy niestandardowe.

Jak rozpowszechniać Toolbox Items w Visual Studio rozszerzenie

Można rozpowszechniać na inne elementy do przybornika Visual Studio użytkowników za pomocą zapakowanie w Visual Studio rozszerzenie (VSIX).Polecenia, profile i innych rozszerzeń można spakować do tego samego pliku VSIX. Aby uzyskać więcej informacji, zobacz Wdrażanie rozszerzeń programu Visual Studio.

Tradycyjny sposób stworzenia rozszerzenia programu Visual Studio jest użycie szablonu projektu VSIX.Aby to zrobić, należy zainstalować Visual Studio SDK.

Aby dodać element przybornika na rozszerzenie programu Visual Studio

Tworzenie i testowanie jeden lub więcej niestandardowych narzędzi.
Utwórz plik .tbxinfo odwołujący się do narzędzi.
Otworzyć istniejący projekt rozszerzenie programu Visual Studio.

- lub -

Zdefiniuj nowy projekt rozszerzenie programu Visual Studio.
1. Na pliku menu, wybierz polecenie New, Projekt.
2. W Nowy projekt dialogowe, pod Szablonów, wybierz polecenie Visual C#, rozszerzalności, projektu VSIX.
Dodać do definicji przybornik do projektu.Obejmują .tbxinfo plików, diagramów pliki, pliki map bitowych i pliki zasobów i upewnij się, że są one uwzględniane w VSIX.
- W oknie Solution Explorer projektu VSIX, w menu skrótów wybierz polecenie Dodaj, Istniejącego elementu.W oknie dialogowym Ustaw obiekty typu: wszystkie pliki.Znajdź pliki, zaznacz je wszystkie, a następnie wybierz Dodaj.
  
  [!UWAGA]
  
  W tym projekcie nie można otworzyć plików diagram w edytorze modeli.
Ustaw następujące właściwości wszystkich plików, które zostały dodane.W tym samym czasie można ustawić ich właściwości, wybierając je wszystkie w oknie Solution Explorer.Należy uważać, aby nie zmieniać właściwości innych plików w projekcie.

Kopiuj do katalogu wyjściowego = zawsze Kopiuj

Budowanie akcji = zawartości

Uwzględnienie w VSIX = PRAWDA
Otwórz source.extension.vsixmanifest.Zostanie otwarty w edytorze manifestu rozszerzenie.
W obszarze metadanych, dodać opis dla narzędzia niestandardowe.

W obszarze aktywów, wybierz polecenie New i następnie ustaw pola w oknie dialogowym się następujące zmiany:
- Typ = niestandardowe rozszerzenia typu
- Typ =Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems
  
  [!UWAGA]
  
  Nie jest jedną z opcji z listy rozwijanej.Musisz go wprowadzić za pomocą klawiatury.
- Źródło = plik na system plików.
- Ścieżka = Twój .tbxinfo pliku, na przykładMyTools.tbxinfo
Skompiluj projekt.
Aby sprawdzić, czy rozszerzenie działa, naciśnij klawisz F5.Uruchamia doświadczalnych wystąpienie programu Visual Studio.

W przypadku eksperymentalnych Utwórz lub Otwórz diagram UML odpowiedniego typu.Sprawdź, czy do nowego narzędzia w przyborniku i tworzący elementy poprawnie.
Aby uzyskać plik VSIX dla wdrażania: w Eksploratorze Windows otwórz folder .\bin\Debug lub .\bin\Release Aby znaleźć .vsix pliku.Jest to Visual Studio pliku rozszerzenia.Może być zainstalowana na komputerze i także wysyłane do innych użytkowników programu Visual Studio.

Aby zainstalować narzędzia niestandardowe z rozszerzeniem Visual Studio

Otwórz .vsix pliku w Eksploratorze Windows lub w programie Visual Studio.
Wybierz polecenie zainstalować pojawi się okno dialogowe.
Aby odinstalować lub tymczasowo wyłączyć rozszerzenia, otwórz Extension Manager z Narzędzia menu.

Lokalizacja

Istnieje możliwość rozszerzenia, które podczas jego instalacji na innym komputerze, narzędzie nazw i etykiet narzędzi w języku będą wyświetlane na komputerze docelowym.

Zapewnienie wersje narzędzia w więcej niż jednym języku

Tworzenie projektu programu Visual Studio rozszerzenie, który zawiera jeden lub więcej niestandardowych narzędzi.

W .tbxinfo pliku, należy użyć metody pliku zasobów do zdefiniowania tego narzędzia displayName, przybornik tabNamei jako etykietka.Utwórz plik zasobów, w której określone są te ciągi, skompiluj go w zespół i odwołują się do niego z pliku tbxinfo.
Tworzyć dodatkowe zestawy, które zawierają pliki zasobów z ciągów w innych językach.
Umieść dodatkowego zestawu w folderze, którego nazwa jest kod kultury języka.Na przykład umieścić francuskiej wersji zestawu w folderze o nazwie fr.
Należy używać kodu kultury neutralnej, zazwyczaj dwie litery, nie określonej kultury takich jak fr-CA.Aby uzyskać więcej informacji na temat kodów kultury, zobacz Metoda CultureInfo.GetCultures, który zapewnia pełną listę kodów kultury.
Stworzenie rozszerzenia programu Visual Studio i rozpowszechnić je.
Rozszerzenie jest zainstalowany na innym komputerze, wersja pliku zasobów dla kultury lokalnym użytkownika będą automatycznie ładowane.Jeśli nie podano wersji dla kultury użytkownika, środki domyślne zostaną wykorzystane.

Tej metody nie można użyć do zainstalowania różnych wersjach diagram prototypu.Nazwy elementów i łączników będzie taki sam w każdej instalacji.

Inne operacje przybornika

Zwykle w Visual Studio, można spersonalizować przybornik, zmiana nazwy narzędzi, przenoszenie ich na różnych przybornik karty i ich usuwania. Jednak zmiany te nie są zachowywane dla narzędzi do modelowania niestandardowe utworzone za pomocą procedury, które opisano w tym temacie.Po ponownym uruchomieniu Visual Studio, niestandardowych narzędzi pojawi się ponownie z ich zdefiniowane nazwy i lokalizacje przybornika.

Ponadto, jeśli przeprowadzasz zniknie przez niestandardowe narzędzia Zresetować przybornik polecenia.Jednakże, pojawi się ponownie po ponownym uruchomieniu Visual Studio.