Edytowanie i dostosowywanie wykresów zależności
Wykresy zależności można edytować bez wpływania na kod źródłowy.Jest to przydatne, gdy użytkownik chce skupić się na kluczowych elementach lub przedstawianiu pomysłów o kodzie.Aby na przykład wyróżnić interesujące obszary, można zaznaczyć węzły i filtrować je, zmieniać style węzłów i łączy, ukrywać lub usuwać węzły czy organizować je za pomocą właściwości, kategorii lub grup.
Można jeszcze bardziej dostosować wykres, edytując plik Directed Graph Markup Language (.dgml) wykresu.Można na przykład edytować elementy, aby określić niestandardowe style, przypisać właściwości i kategorie do węzłów i łączy lub połączyć węzły z elementami takimi jak dokumenty, adresy URL lub inne wykresy.
[!UWAGA]
Visual Studio czyści wszystkie nieużywane atrybuty i elementy DGML, usuwając je podczas zapisywania pliku .dgml.Tworzy również elementy węzła automatycznie podczas ręcznego dodawania nowych łączy.Podczas zapisywania pliku .dgml wszelkie atrybuty, które są dodawane do elementu, mogą się ponownie rozmieszczać w kolejności alfabetycznej.Aby uzyskać więcej informacji dotyczących elementów DGML, zobacz Opis języka Directed Graph Markup Language (DGML).
Wymagania
Programy Visual Studio Ultimate, Visual Studio Premium lub Visual Studio Professional
Aby utworzyć wykresy zależności, musisz mieć program Visual Studio Ultimate.Zobacz sekcję Mapowanie zależności w kodzie na wykresach zależności.
W tym temacie:
Zaznaczanie węzłów lub łączy
Zmiana nazwy węzłów lub łączy
Ukrywanie lub pokazywanie węzłów i łączy
Dodawanie węzłów i łączy
Dodawanie komentarzy do wykresu
Usuwanie węzłów
Grupowanie węzłów
Scalanie wykresów
Zmiana stylu wykresu
Zmiana stylu węzła lub łącza
Kopiowanie stylów z jednego wykresu do innego
Przypisywanie właściwości do węzłów i łączy
Przypisywanie kategorii do węzłów i łączy
Łączenie elementów z węzłami lub łączami
Tworzenie aliasów dla najczęściej używanych ścieżek
Zaznaczanie węzłów lub łączy
Aby |
Wykonaj następujące kroki |
|---|---|
Zaznacz wszystkie węzły niezaznaczone. |
Otwórz menu skrótów dla wybranych węzłów.Wybierz kolejno opcje Zaznacz, Odwróć zaznaczenie. |
Zaznacz dodatkowe węzły, które łączą się z wybranymi. |
Otwórz menu skrótów dla wybranych węzłów.Wybierz Zaznacz, a następnie jedną z następujących czynności:
|
Zmiana nazwy węzłów lub łączy
Zaznacz węzeł lub łącze.Naciśnij klawisz F2.Gdy pojawi się okno edycji, zmień nazwę węzła lub łącza.
Jeśli etykieta jest widoczna, zaznacz etykietę.
Ukrywanie lub pokazywanie węzłów i łączy
Ukrywanie węzłów wyklucza je z udziału w układzie algorytmów.Domyślnie łącza między grupami są ukryte.Łącza grupy współzależności są poszczególnymi łączami połączenia między grupami węzłów.Jeśli grupy są zwinięte, wykres agreguje wszystkie łącza grupy współzależności do pojedynczego łącza między grupami.Gdyby rozwinąć grupę i wybrać węzły wewnątrz grupy, łącza grupy współzależności pojawiają się i pokażą zależności w tej grupie.
.gif "Informacje dotyczące przestrogi") Przestroga |
|---|
Przed udostępnieniem wykresu, który został utworzony w programie Visual Studio Ultimate z tymi, którzy korzystają z programu Visual Studio Premium lub Visual Studio Professional, pamiętaj, by odkryć wszystkie węzły lub łącza grupy współzależności, które powinny widzieć inni użytkownicy.W przeciwnym razie użytkownicy nie mogą odkryć tych elementów. |
Aby ukryć lub pokazać węzły
Aby |
Wykonaj następujące kroki |
|---|---|
Aby ukryć zaznaczone węzły |
|
Aby ukryć węzły niezaznaczone |
|
Aby pokazać ukryte węzły |
|
Aby ukryć węzły, edytując plik .dgml |
|
.gif "Odkryj ikon dzieci")
w lewym górnym rogu grupy.Aby pokazać lub ukryć łącza
Aby |
Na pasku narzędzi wykresu otwórz listę Zmień sposób renderowania łączy na wykresie lub otwórz menu skrótów wykresu. Wybierz: |
|---|---|
Pokazuj łącza grup współzależności przez cały czas |
Pokaż wszystkie łącza grup współzależności Powoduje to ukrycie agregowanych łącz między grupami. |
Pokaż tylko łącza grup współzależności dla zaznaczonych węzłów |
Pokaż łącza grup współzależności na zaznaczonych węzłach |
Ukrywaj łącza grup współzależności przez cały czas |
Ukryj łącza grup współzależności |
Ukrywaj wszystkie łącza (lub pokazuj wszystkie łącza) |
Ukryj wszystkie łącza Aby pokazać wszystkie łącza, ponownie wybierz polecenie Ukryj wszystkie łącza, aby wyłączyć ten tryb. |
Dodawanie węzłów i łączy
Aby dodać nowy niezdefiniowany węzeł |
Wykonaj następujące kroki |
|---|---|
W bieżącej lokalizacji wskaźnika |
Wybierz miejsce umieszczenia nowego węzła na wykresie.Naciśnij Insert. |
Łączy się z zaznaczonym węzłem |
|
Spowoduje to utworzenie łącza do istniejącego węzła z bieżącym fokusem |
Naciskaj klawisz Tab, aż węzeł, do którego chcesz utworzyć łącze, będzie miał ustawiony fokus.Naciśnij Alt+Shift+Insert. |
.gif "Graph narzędzi - Tworzenie węzła z łączem.")
.Aby dodać węzły do |
Wykonaj następujące kroki |
||
|---|---|---|---|
Elementów w rozwiązaniu |
|
||
Elementy powiązane z węzłami na wykresie |
Otwórz menu skrótów dla węzła.Wybierz opcję Pokaż i odpowiedni rodzaj relacji. Dla zestawu wybierz:
Dla klasy należy wybrać:
Dla metody należy wybrać:
Dla pola należy wybrać:
|
||
Skompilowane pliki binarne lub zestawy .NET (.dll i .exe) |
Użyj Eksploratora architektury, aby znaleźć i przeciągnąć elementy i relacje na wykres. |
Aby dodać łącze między istniejącymi węzłami
Zaznacz węzeł źródłowy.
Pasek narzędzi zaczyna być widoczny nad węzłem.
.png "Pasek narzędzi Wykres zależności")
Na pasku narzędzi wybierz polecenie Utwórz nowe łącze z tego węzła do następnego węzła, który zostanie kliknięty
.gif "Graph narzędzi - Tworzenie łącza")
.Zaznacz węzeł docelowy.Zostanie wyświetlone łącze między dwoma węzłami.
Dodawanie komentarzy do wykresu
Zaznacz węzeł, do którego chcesz dodać komentarz połączony.
Pasek narzędzi zaczyna być widoczny nad węzłem.
Na pasku narzędzi wybierz polecenie Utwórz nowy węzeł komentarza z nowym łączem do wybranego węzła
.png "Graph narzędzi - Tworzenie komentarza z łączem.")
.Wpisz swoje komentarze.Aby pisać w nowym wierszu, naciśnij klawisz SHIFT+Enter.
Usuwanie węzłów
Węzły można usunąć z wykresu bez wpływu na kod podstawowy.Aby usunąć węzeł, zaznacz go, a następnie naciśnij klawisz Delete.Po usunięciu węzłów ich definicje są usuwane z pliku DGML (.dgml).
Po usunięciu węzłów z grupy wewnątrz niej pojawia się przycisk Pobierz ponownie elementy podrzędne.png "Ikona dzieci refetch")
.Aby pobrać brakujące węzły, wybierz Pobierz ponownie elementy podrzędne.Wykresy utworzone za pomocą edytowania DGML, dodawania niezdefiniowanych węzłów lub za pomocą wcześniejszych wersji programu Visual Studio Ultimate nie obsługują tej funkcji.
| Przestroga |
|---|
Przed udostępnieniem wykresu, który został utworzony przy użyciu programu Visual Studio Ultimate, użytkownikom korzystającym z programu Visual Studio Premium lub Visual Studio Professional upewnij się, że wszystkie węzły, które powinni widzieć inni użytkownicy, są widoczne na wykresie.W przeciwnym razie użytkownicy ci nie będą mogli pobierać usuniętych węzłów. |
Grupowanie węzłów
Aby |
Wykonaj następujące kroki |
|---|---|
Aby pokazać kontener węzłów jako węzły grup lub węzły liści |
Aby pokazać kontener węzłów jako węzły liści, zaznacz węzły.Otwórz menu skrótów dla zaznaczenia.Wybierz Grupa, Konwertuj na liść. Aby pokazać kontener węzłów jako węzły grup, zaznacz węzły.Otwórz menu skrótów dla zaznaczenia.Wybierz kolejno opcje Grupa, Konwertuj na grupę. Aby pokazać wszystkie węzły liści jako węzły grup, otwórz menu skrótów wykresu.Wybierz kolejno opcje Grupa, Włącz grupowanie. Aby pokazać wszystkie węzły grup jako węzły liści, otwórz menu skrótów wykresu.Wybierz kolejno opcje Grupa, Wyłącz grupowanie. |
Dodaj węzeł do grupy |
Przeciągnij węzeł na grupę. Można również przeciągać węzły na zewnątrz grupy. |
Aby dodać węzeł do niezgrupowanego węzła |
Dowolny węzeł można skonwertować na grupę.Przeciągnij węzeł na węzeł docelowy. |
Aby grupować zaznaczone węzły |
|
Grupowanie węzłów, które mają określone kategorie lub właściwości |
|
Aby grupować węzły według ich wartości właściwości |
|
Aby usunąć grupy |
Zaznacz jedną grupę lub kilka, które chcesz usunąć.Otwórz menu skrótów dla zaznaczenia.Wybierz kolejno opcje Grupa, Usuń grupę. |
Aby usunąć węzły z ich grupy nadrzędnej i przenieść je do grupy ponadnadrzędnej lub na zewnątrz grupy, jeśli nie mają one grupy ponadnadrzędnej |
Zaznacz węzły, które chcesz przenieść.Otwórz menu skrótów dla zaznaczenia.Wybierz kolejno opcje Grupa, Usuń z elementu nadrzędnego. |
.gif "Wykres narzędzi - wybranej grupy")
.Aby grupować węzły, edytując plik .dgml wykresu
Aby skonwertować węzeł na grupę, otwórz menu skrótów dla węzła.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu i wyróżnia element <Node/> dla tego węzła.
—lub—
Aby dodać nową grupę:
Otwórz menu skrótów dla pustego obszaru wykresu.Wybierz Przejdź do, DGML.
W sekcji <Nodes> dodaj nowy element <Node/>.
W elemencie <Node/> dodaj atrybut Group, aby określić, czy grupa pojawia się rozwinięta czy zwinięta.Na przykład:
<Nodes> <Node Id="MyFirstGroup" Group="Expanded" /> <Node Id="MySecondGroup" Group="Collapsed" /> </Nodes>W sekcji <Links> upewnij się, że element <Link/>, który ma następujące atrybuty, istnieje dla każdej relacji między węzłem grupy i jego węzłami podrzędnymi:
Atrybut Source, który określa węzeł grupy
Atrybut Target, który określa węzeł podrzędny
Atrybut Category, który określa relację Contains między węzłem grupy i jego węzłami podrzędnymi
Na przykład:
<Links> <Link Category="Contains" Source="MyFirstNewGroup" Target="FirstGroupChildOne" /> <Link Category ="Contains" Source="MyFirstNewGroup" Target="FirstGroupChildTwo" /> <Link Category ="Contains" Source="MySecondNewGroup" Target="SecondGroupChildOne" /> <Link Category="Contains" Source="MySecondNewGroup" Target="SecondGroupChildTwo" /> </Links>Aby uzyskać więcej informacji dotyczących atrybutu Category, zobacz Przypisz kategorie do węzłów i łączy.
Scalanie wykresów
Wykresy można scalić przez kopiowanie i wklejanie węzłów między wykresami.Jeśli identyfikatory węzłów będą zgodne, wklejanie węzłów działa podobnie jak operacja łączenia.Aby ułatwić to zadanie, należy umieścić wszystkie zestawy lub pliki binarne, które mają być wyświetlane, w tym samym folderze, aby pełna ścieżka każdego zestawu lub plików binarnych była taka sama dla każdego wykresu, który ma zostać scalony.
Alternatywnie można utworzyć pojedynczy wykres dla zestawów lub plików binarnych, które mają być wyświetlane, wykonując jeden z tych kroków:
Przeciągnij zestawy lub pliki binarne na ten sam wykres.
—lub—
Otwórz Eksploratora architektury.W części System plików wybierz opcję Zaznacz pliki, aby przeglądać, zaznaczać i otwierać zestawy lub pliki binarne.Aby udoskonalić wykres, zaznacz określone elementy, które mają być wyświetlane.Po zakończeniu tych czynności wybierz polecenie Utwórz nowy dokument wykresu z wszystkich zaznaczonych węzłów na pasku narzędzi Eksploratora architektury.
Zmiana stylu wykresu
Edytując plik .dgml wykresu, można zmienić kolor tła i kolor obramowania wykresu.Aby zmienić styl węzłów i łączy, zobacz Zmień styl węzłów i łączy.
Otwórz menu skrótów z powierzchni wykresu.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu.
W elemencie <DirectedGraph> dodaj dowolny z następujących atrybutów, aby zmienić jego styl:
Aby zmienić
Dodaj następujący atrybut
Kolor tła
Background="ColorNameOrHexadecimalValue"Kolor obramowania
Stroke="StrokeValue"Na przykład:
<DirectedGraph Background="Green" xmlns="https://schemas.microsoft.com/vs/2009/dgml" > ... ... </DirectedGraph>
Zmiana stylu węzłów i łączy
Można zmienić ikony na węzłach, a także kolory węzłów i łączy.Można użyć wstępnie zdefiniowanych kolorów i ikon lub określić niestandardowe, edytując plik .dgml wykresu.Zobacz sekcję Zastosuj niestandardowe style do węzłów i łączy.
Na przykład można wybrać kolor, aby wyróżnić węzły i łącza, które mają określoną właściwość lub kategorię.Dzięki temu można zidentyfikować i skupić się na konkretnym obszarze wykresu.
Aby zastosować wstępnie zdefiniowany kolor lub ikonę do węzłów z określoną kategorią lub właściwością
Jeśli pole Legenda nie jest widoczne, otwórz menu skrótów dla wykresu.Wybierz opcję Pokaż legendę.
W polu Legenda sprawdź, czy kategoria lub właściwość węzła pojawia się na liście.
Jeżeli lista nie zawiera kategorii lub właściwości, wybierz + w polu Legenda, Kategoria węzła lub Właściwość węzła, a następnie kategorię lub właściwość.
Kategoria lub właściwość pojawi się w polu Legenda.
[!UWAGA]
Aby utworzyć i przypisać kategorię do węzła, zobacz sekcję Przypisz kategorie do węzłów i łączy.Aby utworzyć i przypisać właściwość do węzła, zobacz sekcję Przypisz właściwości do węzłów i łączy.
W polu Legenda otwórz listę rozwijaną obok kategorii lub właściwości.
Skorzystaj z poniższej tabeli, aby wybrać styl, który ma zostać zmieniony:
Aby zmienić
Wybierz
Kolor tła
Tło
Kolor konturu
Pociągnięcie
Kolor tekstu
Pierwszy plan
Ikona
Ikony
Pojawi się pole Selektor zestawu kolorów umożliwiające wybranie koloru (lub ikony).
W oknie dialogowym Selektor zestawu kolorów wykonaj jedną z następujących czynności:
Aby zastosować
Wykonaj następujące kroki
Zestaw kolorów (lub ikon)
Otwórz listę Wybierz zestaw kolorów (lub ikon).Wybierz zestaw kolorów (lub ikon).
Aby przywrócić domyślny kolor (lub ikonę), na liście Wybierz zestaw kolorów (ikon) wybierz Brak.
Określony kolor (lub ikona)
Otwórz listę wartości kategorii lub właściwości.Wybierz kolor (lub ikonę).
[!UWAGA]
Można ponownie rozmieścić, usunąć lub tymczasowo dezaktywować style w polu Legenda.Zobacz sekcję Modyfikuj pole legendy.
Aby zastosować wstępnie zdefiniowany kolor do łączy z określoną kategorią lub właściwością
Jeśli pole Legenda nie jest widoczne, otwórz menu skrótów dla wykresu.Wybierz opcję Pokaż legendę.
W polu Legenda sprawdź, czy kategoria lub właściwość pojawia się na liście.
Jeżeli lista nie zawiera kategorii lub właściwości, wybierz + w polu Legenda, Kategoria łącza lub Właściwość łącza, a następnie kategorię lub właściwość.
Kategoria lub właściwość pojawi się w polu Legenda.
[!UWAGA]
Aby utworzyć i przypisać kategorię do łącza, zobacz sekcję Przypisz kategorie do węzłów i łączy.Aby utworzyć i przypisać właściwość do łącza, zobacz sekcję Przypisz właściwości do węzłów i łączy.
W polu Legenda otwórz listę obok kategorii lub właściwości.
Wybierz Pociągnięcie, aby zmienić kolor konturu łącza i grotu strzałki.
Pojawi się pole Selektor zestawu kolorów umożliwiające wybranie koloru.
W polu Selektor zestawu kolorów wykonaj jedną z następujących czynności:
Aby zastosować
Wykonaj następujące kroki
Zestaw kolorów
Otwórz listę Wybierz zestaw kolorów.Wybierz zestaw kolorów.
Aby przywrócić domyślny kolor, na liście Wybierz zestaw kolorów wybierz Brak.
Określony kolor
Otwórz listę wartości typu lub właściwości, aby wybrać kolor.
[!UWAGA]
Można ponownie rozmieścić, usunąć lub tymczasowo dezaktywować style w polu Legenda.Zobacz sekcję Modyfikuj pole legendy.
Zastosuj niestandardowe style do węzłów i łączy
Style niestandardowe można stosować do następujących elementów:
Pojedynczych węzłów i łączy
Grup węzłów i łączy
Grup węzłów i łączy na podstawie określonych warunków
Aby zastosować styl niestandardowy do pojedynczego węzła
Otwórz menu skrótów dla węzła, którego styl ma zostać dostosowany.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu i wyróżnia element <Node/> dla tego węzła.
W elemencie <Node/> dodaj dowolny z następujących atrybutów, aby dostosować jego styl:
Aby zmienić
Dodaj następujący atrybut
Kolor tła
Background="ColorNameOrHexadecimalValue"Kontur
Stroke="ColorNameOrHexadecimalValue"Grubość konturu
StrokeThickness="StrokeValue"Kolor tekstu
Foreground="ColorNameOrHexadecimalValue"Ikona
Icon="IconFilePathLocation"Rozmiar tekstu
FontSize="FontSizeValue"Typ tekstu
FontFamily="FontFamilyName"Waga tekstu
FontWeight="FontWeightValue"Styl tekstu
FontStyle="FontStyleName"Na przykład można określić Italic jako styl tekstu.
Tekstura
Style="Glass"- lub -
Style="Plain"Kształt
Aby zamienić kształt ikony, należy ustawić właściwość Shape na None i ustawić właściwość Icon na ścieżkę z plikiem ikony.
Shape="ShapeFilePathLocation"Na przykład:
<Nodes> <Node Id="MyNode" Background="#FF008000" Stroke="#FF000000" Foreground="#FFFFFFFF" Icon="...\Icons\Globe.png"/> </Nodes>
Aby zastosować styl niestandardowy do pojedynczego łącza
Na wykresie przesuń wskaźnik myszy na łącze.Etykietka narzędzia pojawia się i identyfikuje węzeł źródłowy i węzeł docelowy łącza. (Klawiatura: naciskajklawisz Tab, aż fokus znajdzie się na łączu).
Otwórz menu skrótów wykresu.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu.
Znajdź element <Link/>, który zawiera nazwy węzła źródłowego i węzła docelowego.
W elemencie <Link/> dodaj dowolny z następujących atrybutów, aby dostosować jego styl:
Aby zmienić
Dodaj następujący atrybut
Kolor konturu i grotu strzałki
Stroke="ColorNameOrHexadecimalValue"Grubość konturu
StrokeThickness="StrokeValue"Styl konturu
StrokeDashArray="StrokeArrayValues"Na przykład:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Background="Green" Stroke="#FF000000" StrokeDashArray="2,2"/> </Links>
Aby zastosować niestandardowe style do grupy węzłów lub łączy
Przypisz wszystkie wybrane kategorie lub właściwości do węzłów lub łączy.
.gif "Porada")
PoradaJeśli istnieją powtarzające się style w wielu węzłach lub łączach, można rozważyć zastosowanie kategorii do tych węzłów lub łączy, a następnie zastosowanie stylu do tej kategorii.Aby uzyskać więcej informacji, zobacz sekcję Przypisz kategorie do węzłów i łączy i Przypisz właściwości do węzłów i łączy.
Otwórz menu skrótów dla powierzchni wykresu.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu.
Jeśli element <Styles></Styles> nie istnieje, należy dodać go pod elementem <DirectedGraph></DirectedGraph> po elemencie <Links></Links>.
W elemencie <Styles></Styles>, pod elementem <Style/> należy określić następujące atrybuty:
TargetType="Node | Link | Graph"
GroupLabel="NameInLegendBox"
ValueLabel="NameInStylePickerBox"
Aby zastosować niestandardowy styl do wszystkich typów docelowych, nie należy używać warunku.
Aby zastosować styl warunkowy do grupy węzłów lub łączy
W elemencie <Style/> dodaj element <Condition/>, który zawiera atrybut Expression, aby określić wyrażenie zwracające wartość typu Boolean.
Na przykład:
<Condition Expression="MyCategory"/>- lub -
<Condition Expression="MyCategory > 100"/>- lub -
<Condition Expression="HasCategory('MyCategory')"/>Wyrażenie to używa następującej składni notacji Backusa-Naura (BNF):
<Expression> ::= <BinaryExpression> | <UnaryExpression> | "("<Expression>"")"" | <MemberBindings> | <Literal> | <Number>
<BinaryExpression> ::= <Expression> <Operator> <Expression>
<UnaryExpression> ::= "!" <Expression> | "+" <Expression> | "-" <Expression>
<Operator> ::= "<" | "<=" | "=" | ">=" | ">" | "!=" | "or" | "and" | "+" | "*" | "/" | "-"
<MemberBindings> ::= <MemberBindings> | <MemberBinding> "." <MemberBinding>
<MemberBinding> ::= <MethodCall> | <PropertyGet>
<MethodCall> ::= <Identifier> "(" <MethodArgs> ")"
<PropertyGet> ::= Identifier
<MethodArgs> ::= <Expression> | <Expression> "," <MethodArgs> | <empty>
<Identifier> ::= [^. ]*
<Literal> ::= literał ciągu znaków objęty pojedynczym lub podwójnym cudzysłowem
<Number> ::= ciąg cyfr z opcjonalnym przecinkiem dziesiętnym
Można określić wiele elementów <Condition/> , które muszą być spełnione, aby zastosować styl.
W następnym wierszu po elemencie <Condition/> należy dodać jeden lub wiele elementów <Setter/>, aby określić atrybut Property i stały atrybut Value lub obliczany atrybut Expression i zastosować do wykresu, węzłów lub łączy, które spełniają warunek.
Na przykład:
<Setter Property="BackGround" Value="Green"/>
Jako prosty, kompletny przykład następujący warunek określa, że węzeł pojawi się jako zielony lub czerwony, w zależności od tego, czy jego kategoria Passed jest ustawiona na True czy False:
<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
<Nodes>
<Node Id="MyFirstNode" Passed="True" />
<Node Id="MySecondNode" Passed="False" />
</Nodes>
<Links>
</Links>
<Styles>
<Style TargetType="Node" GroupLabel="Passed" ValueLabel="True">
<Condition Expression="Passed='True'"/>
<Setter Property="Background" Value="Green"/>
</Style>
<Style TargetType="Node" GroupLabel="Passed" ValueLabel="False">
<Condition Expression="Passed='False'"/>
<Setter Property="Background" Value="Red"/>
</Style>
</Styles>
</DirectedGraph>
Poniższa tabela zawiera niektóre przykładowe warunki, których można użyć:
Modyfikuj pole legendy
Można ponownie rozmieścić, usunąć lub tymczasowo dezaktywować style w polu Legenda.
Otwórz menu skrótów dla stylu w polu Legenda.
Wykonaj jedno z następujących zadań:
Aby
Wybierz
Przenieś styl w górę
Przenieś w górę
Przenieś element w dół
Przenieś w dół
Usuń element
Usuń
Dezaktywuj element
Wyłącz
Ponownie aktywuj element
Włącz
Kopiowanie stylów z jednego wykresu do innego
Upewnij się, że pole Legenda pojawia się na wykresie źródłowym.Jeśli nie jest widoczne, otwórz menu skrótów dla pustego obszaru wykresu źródłowego.Wybierz opcję Pokaż legendę.
Otwórz menu skrótów dla pola Legenda.Wybierz opcję Kopiuj legendę.
Wklej legendę na wykres docelowy.
Przypisywanie właściwości do węzłów i łączy
Węzły i łącza można organizować przez przypisywanie im właściwości.Można na przykład wybrać węzły, które mają szczególne właściwości, tak aby pogrupować je, zmienić ich styl lub je ukryć.
Aby przypisać właściwość do węzła
Otwórz menu skrótów dla węzła.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu i wyróżnia element <Node/> dla tego węzła.
W elemencie <Node/> należy określić nazwę właściwości i jej wartość.Na przykład:
<Nodes> <Node Id="MyNode" MyPropertyName="PropertyValue" /> </Nodes>Dodaj element <Property/> do sekcji <Properties>, aby określić atrybuty, takie jak jego widoczna nazwa i typ danych:
<Properties> <Property Id="MyPropertyName" Label="My Property" DataType="System.DataType"/> </Properties>
Aby przypisać właściwość do łącza
Na wykresie przesuń wskaźnik myszy na łącze.Etykietka narzędzia pojawia się i identyfikuje węzeł źródłowy i węzeł docelowy łącza. (Klawiatura: naciskaj klawisz Tab, aż fokus pojawi się na łączu).
Otwórz menu skrótów wykresu.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu.
Znajdź element <Link/>, który zawiera nazwy węzła źródłowego i węzła docelowego.
W elemencie <Node/> należy określić nazwę właściwości i jej wartość.Na przykład:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" /> </Links>Dodaj element <Property/> do sekcji <Properties>, aby określić atrybuty, takie jak jego widoczna nazwa i typ danych:
<Properties> <Property Id="MyPropertyName" Label="My Property Name" DataType="System.DataType"/> </Properties>
Przypisywanie kategorii do węzłów i łączy
Można organizować węzły przez przypisywanie do nich kategorii.Można na przykład wybrać węzły, które są w pewnych kategoriach, dzięki czemu można je pogrupować, zmienić ich styl lub je ukryć.Można wyróżnić łącza, które mają określone kategorie.Aby uzyskać więcej informacji, zobacz następujące sekcje:
Grupowanie węzłów
Zmiana stylu węzłów i łączy
Ukrywanie lub pokazywanie węzłów
Przypisywanie kategorii do węzła
- Aby przypisać wstępnie zdefiniowaną kategorię, taką jak Kategoria 1, otwórz menu skrótów dla węzła.Wybierz Kategoryzuj i wstępnie zdefiniowaną kategorię.
- lub -
Aby utworzyć i przypisać kategorię niestandardową:
- Wybierz węzeł, który ma być kategoryzowany.Naciśnij F4, aby otworzyć okno Właściwości.Wpisz nazwę kategorii we właściwości Nowa kategoria węzła.Naciśnij klawisz ENTER.
- lub -
Otwórz menu skrótów dla węzła.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu i wyróżnia element <Node/> dla tego węzła.
W elemencie <Node/> dodaj atrybut Category, aby określić nazwę kategorii.Na przykład:
<Nodes> <Node Id="MyNode" Category="MyCategory" /> </Nodes>Dodaj element <Category/> do sekcji <Categories> tak, aby można było użyć atrybutu Label do określenia tekstu wyświetlanego dla tej kategorii:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
Przypisywanie kategorii do łącza
Na wykresie przesuń wskaźnik myszy nad łącze, aby pokazać etykietkę narzędzia i zidentyfikować węzeł źródłowy oraz węzeł docelowy łącza. (Klawiatura: naciskaj klawisz Tab, aż fokus pojawi się na łączu).
Otwórz menu skrótów wykresu.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu.
Znajdź element <Link/>, który zawiera nazwy węzła źródłowego i węzła docelowego.
W elemencie <Link/> dodaj atrybut Category, aby określić nazwę kategorii.Na przykład:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory" </Links>Dodaj element <Category/> do sekcji <Categories> tak, aby można było użyć atrybutu Label do określenia tekstu wyświetlanego dla tej kategorii:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
Można utworzyć hierarchiczne kategorie, aby ułatwić organizowanie węzłów i dodawanie atrybutów do kategorii podrzędnych za pomocą dziedziczenia.
Tworzenie kategorii hierarchicznych
Dodaj element <Category/> dla kategorii nadrzędnej, a następnie dodaj atrybut BasedOn do kategorii <Category/> elementu podrzędnego.
Na przykład:
<Nodes> <Node Id="MyFirstNode" Label="My First Node" Category= "MyCategory" /> <Node Id="MySecondNode" Label="My Second Node" /> </Nodes> <Links> <Link Source="MyFirstNode" Target="MySecondNode" /> </Links> <Categories> <Category Id="MyCategory" Label="My Category" BasedOn="MyParentCategory"/> <Category Id="MyParentCategory" Label="My Parent Category" Background="Green"/> </Categories>W tym przykładzie tło MyFirstNode jest zielone, ponieważ jego atrybut Category dziedziczy atrybut Background z MyParentCategory.
Łączenie elementów z węzłami lub łączami
Można łączyć elementy, takie jak dokumenty lub adresy URL, z węzłem lub łączem, edytując plik .dgml wykresu i dodając atrybut Reference do elementu <Node/> dla węzła lub elementu <Link/> dla łącza.Można otworzyć i wyświetlić tę zawartość z węzła lub łącza.Atrybut Reference określa ścieżkę tej zawartości.Może to być ścieżka względem lokalizacji pliku .dgml lub ścieżka bezwzględna.
| Przestroga |
|---|
Jeśli używane są ścieżki względne, a plik .dgml zostanie przeniesiony do innej lokalizacji, ścieżki te nie zostaną rozpoznane.Podczas próby otwarcia i wyświetlenia połączonej zawartości pojawi się komunikat o błędzie z informacją, że nie można wyświetlić zawartości. |
Można na przykład połączyć następujące elementy:
Aby opisać zmiany w klasie, można połączyć adres URL elementu roboczego, dokument lub inny plik .dgml z węzłem do klasy.
Można połączyć diagram warstwy z węzłem grupy, który reprezentuje warstwę w logicznej architekturze oprogramowania.
Aby pokazać więcej informacji na temat składnika, który udostępnia interfejs, można połączyć diagram składników z węzłem do tego interfejsu.
Utwórz łącze z węzła do usterki lub elementu pracy Team Foundation Server albo innej informacji związanej z węzłem.
Aby połączyć element z węzłem
Na wykresie otwórz menu skrótów dla węzła.Wybierz Przejdź do, DGML.
Program Visual Studio otwiera plik .dgml wykresu i wyróżnia element <Node/> dla tego węzła.
Wykonaj jedno z zadań z tabeli poniżej:
Aby połączyć
Wykonaj następujące kroki
Pojedynczy element
W elemencie <Node/> lub <Link/> dodaj atrybut Reference, aby określić jego lokalizację.
[!UWAGA]
Można mieć tylko jeden atrybut Reference dla każdego elementu.
Na przykład:
<Nodes> <Node Id="MyNode" Reference="MyDocument.txt" /> </Nodes> <Properties> <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" /> </Properties>Wiele elementów
W elemencie <Node/> lub <Link/> dodaj nowy atrybut, aby określić lokalizację każdego odwołania.
W sekcji <Properties>:
Dodaj element <Property/> dla każdego nowego typu odwołania.
Ustaw atrybut Id na nazwę nowego atrybutu odwołania.
Dodaj atrybut IsReference i ustaw go na True, aby odwołanie pojawiało się w menu skrótów Goto elementu.
Użyj atrybutu Label, aby określić tekst wyświetlany w menu skrótów Goto elementu.
Na przykład:
<Nodes> <Node Id="MyNode" SequenceDiagram="MySequenceDiagram.sequencediagram" ActiveBugs="MyActiveBugs.wiq"/> </Nodes> <Properties> <Property Id="SequenceDiagram" Label="My Sequence Diagram" DataType="System.String" IsReference="True" /> <Property Id="ActiveBugs" Label="Active Bugs" DataType="System.String" IsReference="True" /> </Properties>Na wykresie nazwa węzła jest podkreślana.Po otwarciu menu skrótów dla węzła lub łącza będzie widoczne menu skrótów Goto zawierające połączone elementy do wyboru.
Użyj atrybutu ReferenceTemplate, aby określić wspólny ciąg, taki jak adres URL, który jest używany przez wiele odwołań zamiast powtarzania tego ciągu w odwołaniu.
Atrybut ReferenceTemplate określa symbol zastępczy dla wartości odwołania.W poniższym przykładzie symbol zastępczy {0} w atrybucie ReferenceTemplate zostanie zamieniony na wartości atrybutów MyFirstReference i MySecondReference w elemencie <Node/>, aby utworzyć pełną ścieżkę:
<Nodes> <Node Id="MyNode" MyFirstReference="MyFirstDocument" MySecondReference="MySecondDocument"/> <Node Id="MySecondNode" MyFirstReference="AnotherFirstDocument" MySecondReference="AnotherSecondDocument"/> </Nodes> <Properties> <Property Id="MyFirstReference" Label="My First Document" DataType="System.String" IsReference="True" ReferenceTemplate="http://www.Fabrikam.com/FirstDocuments/{0}.asp"/> <Property Id="MySecondReference" Label="My Second Document" DataType="System.String" IsReference="True" ReferenceTemplate=" http://www.Fabrikam.com/SecondDocuments/{0}.asp"/> </Properties>Aby wyświetlić na wykresie jeden element lub kilka, do których istnieją odwołania, otwórz menu skrótów dla węzła lub łącza.Wybierz Goto, a następnie element.
Tworzenie aliasów dla najczęściej używanych ścieżek
Zamienianie najczęściej używanych ścieżek na aliasy pomaga zredukować rozmiar pliku .dgml i czas wymagany do załadowania lub zapisania pliku.Aby utworzyć alias, należy dodać sekcję <Paths></Paths> na końcu pliku .dgml.W tej sekcji dodaj element <Path/>, aby zdefiniować alias dla ścieżki:
<Paths>
<Path Id="MyPathAlias" Value="C:\...\..." />
</Paths>
Aby odwołać się do aliasu z elementu w pliku .dgml, należy otoczyć wartość Id elementu <Path/> znakiem dolara ($) i nawiasami (()):
<Nodes>
<Node Id="MyNode" Reference="$(MyPathAlias)MyDocument.txt" />
</Nodes>
<Properties>
<Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" />
</Properties>
Znajomość Directed Graph Markup Language (DGML)
DGML używa prostego formatu XML do opisu cyklicznie i acyklicznie kierowanych wykresów.Wykres kierowany jest zestawem węzłów połączonych przez łącza lub krawędzie.Węzły i łącza mogą być używane do reprezentacji struktur sieciowych, takich jak elementy projektu oprogramowania.Można wizualizować informacje, przeprowadzać analizę złożoności lub po prostu przeglądać i edytować kierowane wykresy za pomocą DGML.
Węzły i łącza są nazywane elementami wykresów lub po prostu elementami.W poniższej tabeli opisano rodzaje elementów, które są używane w DGML:
[!UWAGA]
Podczas edycji pliku .dgml technologia IntelliSense pomaga identyfikować atrybuty, które są dostępne dla każdego elementu i ich wartości.Aby określić kolor w atrybucie, użyj nazw dla pospolitych kolorów, takich jak „Niebieski” lub wartości szesnastkowych ARGB, takich jak „#ffa0b1c3”.DGML używa małego podzbioru formatów definicji koloru Windows Presentation Foundation (WPF).Aby uzyskać więcej informacji, zobacz Klasa Kolory.
Element |
Przykładowy format |
|---|---|
<DirectedGraph></DirectedGraph> Element ten jest głównym elementem dokumentu wykresu kierowanego (.dgml).Wszystkie inne elementy DGML pojawiają się w zakresie tego elementu. Na poniższej liście opisano opcjonalne atrybuty, które mogą obejmować:
|
|
<Nodes></Nodes> Ten opcjonalny element zawiera listę elementów <Node/>, które definiują węzły na wykresie.Aby uzyskać więcej informacji, zobacz element <Node/>.
|
|
<Node/> Element ten określa pojedynczy węzeł.Pojawia się on w ramach listy elementów <Nodes><Nodes/>. Element ten musi zawierać następujące atrybuty:
Na poniższej liście opisano niektóre z opcjonalnych atrybutów, z których można skorzystać:
|
|
<Links></Links> Element ten zawiera listę elementów <Link>, które definiują łącza między węzłami.Aby uzyskać więcej informacji, zobacz element <Link/>. |
|
<Link/> Element ten określa pojedyncze łącze, które łączy węzeł źródłowy z węzłem docelowym.Pojawia się on w ramach listy elementów <Links></Links>.
Element ten musi zawierać następujące atrybuty:
Na poniższej liście opisano niektóre z opcjonalnych atrybutów, z których można skorzystać:
|
|
<Categories></Categories> Element ten zawiera listę elementów <Category/>.Aby uzyskać więcej informacji, zobacz element <Category/>. |
|
<Category/> Element ten definiuje atrybut Category używany do identyfikowania elementów współdzielących ten atrybut.Atrybut Category może służyć do organizowania elementów wykresów, dostarczania współdzielonych atrybutów poprzez dziedziczenie lub definiowania dodatkowych metadanych. Element ten musi zawierać następujące atrybuty:
Na poniższej liście opisano niektóre z opcjonalnych atrybutów, z których można skorzystać:
Kategorie dostarczają również niektórych podstawowych zachowań szablonu, które kontrolują wygląd węzłów i łączy, gdy są one wyświetlane na wykresie.Zobacz sekcję Zastosuj niestandardowe style do węzłów i łączy. |
|
<Properties></Properties> Element ten zawiera listę elementów <Property/>.Aby uzyskać więcej informacji, zobacz element <Property/>. |
|
<Property/> Element ten definiuje atrybut Property, który służy do przypisywania wartości do dowolnych atrybutów lub elementów DGML, włączając kategorie i inne właściwości. Element ten musi zawierać następujące atrybuty:
Aby właściwość pojawiła się w oknie Właściwości, należy użyć właściwości Label w celu określenia nazwy wyświetlania właściwości. Zobacz sekcję Przypisywanie właściwości do węzłów i łączy. |
|