Sdílet prostřednictvím


Úpravy a přizpůsobení grafů závislostí

Grafy závislosti lze upravovat bez ovlivnění původního kódu.To je užitečné, když se chcete zaměřit na klíčové položky nebo sdělovat nápady týkající se kódu.Například pro zvýraznění zajímavých oblastí lze vybrat uzly a filtrovat je, změnit styl uzlů a propojení, skrýt nebo smazat uzly a organizovat uzly pomocí vlastností, kategorií nebo skupin.

Graf lze dále přizpůsobit úpravou souboru .dgml (Directed Graph Markup Language) grafu.Pomocí úpravy prvků lze například určit vlastní styly, přiřadit vlastnosti a kategorie uzlům a propojením nebo propojit uzly s položkami, jako jsou například dokumenty, adresy URL nebo jiné grafy.

[!POZNÁMKA]

Systém Visual Studio vyčistí všechny nepoužívané prvky a atributy DGML odstraněním při uložení souboru .dgml.Rovněž při ručním přidání nových propojení automaticky vytváří prvky uzlu.Při ukládání souboru .dgml mohou být všechny atributy, které byly přidány do prvku, uspořádány podle abecedy.Další informace o prvcích DGML lze nalézt v tématu Principy jazyka DGML (Directed Graph Markup Language).

Požadavky

V tomto tématu

  • Výběr uzlů a propojení

  • Přejmenování uzlů a propojení

  • Skrytí nebo zobrazení uzlů a propojení

  • Přidání uzlů a propojení

  • Přidání komentářů do grafu

  • Mazání uzlů

  • Seskupování uzlů

  • Sloučení grafů

  • Změna stylu grafu

  • Změna stylu uzlu nebo propojení

  • Kopírování stylů z jednoho grafu do jiného

  • Přiřazení vlastností uzlům a propojením

  • Přiřazení kategorií uzlům a propojením

  • Připojení položek k uzlům a propojením

  • Vytvoření aliasů pro běžně používané cesty

Výběr uzlů a propojení

Chcete-li

Proveďte tyto kroky

Výběr všech nevybraných uzlů

Otevřete místní nabídku zvolených uzlů.Zvolte příkazy Vybrat a Invertovat výběr.

Vybrání dalších uzlů, které jsou propojeny s již vybranými uzly

Otevřete místní nabídku zvolených uzlů.Zvolte příkaz Vybrat a pokračujte jedním z následujících způsobů:

  • Chcete-li zvolit další uzly, které jsou propojeny přímo se zvoleným uzlem, klikněte na příkaz Příchozí závislosti.

  • Chcete-li zvolit další uzly, které jsou propojeny přímo ze zvoleného uzlu, vyberte příkaz Odchozí závislosti.

  • Chcete-li zvolit další uzly, které jsou propojeny přímo do a ze zvoleného uzlu, vyberte příkaz Obě.

  • Chcete-li navíc zvolit všechny uzly, které jsou propojeny do a z vybraného uzlu, vyberte příkaz Připojený podgraf.

  • Chcete-li navíc zvolit všechny uzly podřízené zvolenému uzlu, vyberte příkaz Podřízení.

Přejmenování uzlů a propojení

  • Vyberte uzel nebo propojení.Stiskněte klávesu F2.Jakmile se zobrazí textové pole, uzel nebo propojení přejmenujte.

    Pokud je zobrazen popisek, vyberte jej.

Skrytí nebo zobrazení uzlů a propojení

Skrytí uzlů umožňuje vynechat tyto uzly při použití algoritmů rozložení.Ve výchozím nastavení jsou propojení mezi skupinami skryta.Propojení mezi skupinami jsou jednotlivá propojení, která spojují uzly mezi skupinami.Jsou-li skupiny sbaleny, graf shromáždí všechna propojení mezi skupinami do jediného propojení.Pokud skupinu rozbalíte a vyberete v ní uzly, zobrazí se propojení mezi skupinami, která znázorňují závislosti v této skupině.

Poznámka k upozorněníUpozornění

Před sdílením grafu vytvořeného v aplikaci Visual Studio Ultimate s uživateli aplikace Visual Studio Premium nebo Visual Studio Professional se ujistěte, že jsou zobrazeny všechny uzly nebo propojení mezi skupinami, které mají tito uživatelé vidět.V opačném případě uživatelé nebudou moci tyto položky zobrazit.

Skrytí nebo zobrazení uzlů

Chcete-li

Proveďte tyto kroky

Skrytí vybraných uzlů

  1. Vyberte uzly, které chcete skrýt.

  2. Otevřete místní nabídku zvolených uzlů nebo grafu.Zvolte příkazy Vybrat a Skrýt vybrané.

Skrytí nevybraných uzlů

  1. Vyberte uzly, které mají zůstat viditelné.

  2. Otevřete místní nabídku zvolených uzlů nebo grafu.Zvolte příkazy Vybrat a Skrýt nevybrané.

Zobrazení skrytých uzlů

  • Chcete-li zobrazit všechny skryté uzly ve skupině, ujistěte se nejprve, zda je skupina rozbalena.Zvolte příkaz Odkrýt podřízenéOdkrýt ikonu děti v levém horním rohu skupiny.

  • Chcete-li zobrazit všechny skryté uzly, otevřete místní nabídku grafu.Zvolte možnost Výběr a Odkrýt vše.

Skrytí uzlů úpravou souboru .dgml

  1. Otevřete místní nabídku pro graf.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml.

  2. Chcete-li skrýt uzel, přidejte do prvku <Node/> následující atribut:

    Visibility="Hidden"

    Příklad:

    <Nodes>
       <Node Id="MyNode" Visibility="Hidden"/>
    </Nodes>

Zobrazení nebo skrytí propojení

Chcete-li

Na panelu nástrojů grafu otevřete seznam Změna vykreslování propojení v grafu nebo místní nabídku grafu. Zvolte:

Trvalé zobrazení propojení mezi skupinami

Zobrazení všech propojení mezi skupinami

Tím budou skryta souhrnná propojení mezi skupinami.

Zobrazení propojení mezi skupinami pouze pro vybrané uzly

Zobrazení propojení mezi skupinami pro vybrané uzly

Trvalé skrytí propojení mezi skupinami

Skrytí propojení mezi skupinami

Skrytí (nebo zobrazení) všech propojení

Skrytí všech propojení

Chcete-li všechna propojení zobrazit, zvolte znovu příkaz Skrýt všechny odkazy, čímž bude tento režim vypnut.

Přidání uzlů a propojení

Přidání nového nedefinovaného uzlu

Proveďte tyto kroky

Na aktuální pozici ukazatele myši

Vyberte místo v grafu, kam chcete vložit nový uzel.Stiskněte klávesu Insert.

Tím vytvoříte propojení s vybraným uzlem

  1. Vyberte zdrojový uzel.

    Panel nástrojů se začne zobrazovat nad uzlem.

    Panel nástrojů grafu závislostí

  2. Na panelu nástrojů zvolte možnost Vytvořit uzel se stejnou kategorií jako má tento uzel a přidat na něj nové propojeníPanel nástrojů grafu - umožňuje vytvořit uzel pomocí odkazu.

  3. Vyberte místo v grafu, kam chcete vložit nový uzel.

    (Klávesnice: Stiskněte klávesu Tab, dokud se uzel, ze kterého chcete, aby propojení vedlo, nezvýrazní, a pak stiskněte kombinaci kláves Alt+Insert.)

Tím vytvoříte propojení se zvýrazněným existujícím uzlem

Stiskněte klávesu Tab, dokud se uzel, se kterým chcete vytvořit propojení, nezvýrazní.Stiskněte kombinaci kláves Alt+Shift+Insert.

Přidání uzlů pro

Proveďte tyto kroky

Položky v řešení

  1. Vyhledejte položku v Průzkumníku řešení.Použijte pole vyhledávání v Průzkumníku řešení nebo řešení procházejte.Informace o tom, jak procházet kód v Průzkumníku řešení, lze nalézt v tématu Zobrazení struktury kódu.

    Tip

    Pro vyhledání položek, které mají závislosti na typu nebo členu, otevřete místní nabídku pro typ nebo člen v Průzkumníku řešení.Vyberte vztah, který vás zajímá.

    Průzkumník řešení zobrazí pouze položky se zadanými závislostmi.

  2. Přetáhněte položky, které vás zajímají, na plochu grafu.

    Pro vložení hierarchie nadřazeného kontejneru pro vybrané položky v systému Visual Studio Ultimate stiskněte a podržte klávesu Ctrl při přetahování položky do grafu.

    - nebo -

    Průzkumníku řešení otevřete seznam Vytvořit nový dokument grafu... .Vyberte možnost Přidat do grafu aktivních závislostí.Pro přidání hierarchie nadřazeného kontejneru zvolte raději možnost Přidat do grafu aktivních závislostí s nadřazenou hierarchií.

    Systém Visual Studio přidá do výběru uzly pro položky kódu na nejvyšší úrovni.Pro zjištění, zda uzel obsahuje položky, přesuňte ukazatel myši nad uzel, dokud se neobjeví dvojitá šipka (^).Kliknutím na dvojitou šipku (^) rozbalte uzel.Chcete-li rozbalit všechny uzly, otevřete místní nabídku grafu.Zvolte možnost Skupina > Rozbalit vše.

    [!POZNÁMKA]

    Tento příkaz není k dispozici v případě, že rozšíření všech skupin generuje nepoužitelný graf nebo problémy s pamětí.

Položky vztahující se k uzlům v grafu

Otevřete místní nabídku uzlu.Vyberte možnost Zobrazit a druh vztahu, který vás zajímá.

V případě sestavení zvolte:

  • Odkazovaná sestavení: Přidat sestavení, na která toto sestavení odkazuje.Externí sestavení se zobrazí ve skupině Externí typy.

  • Odkazující sestavení: Přidat do řešení sestavení, která odkazují na toto sestavení.

V případě třídy zvolte:

  • Základní typy: V případě třídy přidat základní třídu a implementovaná rozhraní.

    V rámci rozhraní přidejte základní rozhraní.

  • Odvozené typy: V případě třídy přidat odvozené třídy.

    V rámci rozhraní přidejte odvozené rozhraní a implementaci tříd nebo struktur.

  • Všechny základní typy: Přidat rekurzivně hierarchii základní třídy nebo rozhraní.

  • Všechny odvozené typy: V případě třídy přidat rekurzivně všechny odvozené třídy.

    V rámci rozhraní přidejte rekurzivně veškerá odvozená rozhraní a implementaci tříd nebo struktur.

  • Hierarchie obsahu: Přidat hierarchii nadřazeného kontejneru.

  • Použité typy: Přidat všechny třídy a jejich členy, které tato třída používá.

  • Používající typy: Přidat všechny třídy a jejich členy, které tuto třídu používají.

V případě metody zvolte:

  • Hierarchie obsahu: Přidat hierarchii nadřazeného kontejneru.

  • Volané metody: Přidat metody, které tato metoda volá.

  • Volající metody: Přidat metody, které tuto metodu volají.

  • Přepsané metody v základních typech: V případě metod, které přepisují jiné metody nebo implementují metodu rozhraní, přidat všechny abstraktní nebo virtuální metody základních tříd, které jsou přepsány a případně metody rozhraní, které jsou implementovány.

  • Odkazovaná pole: Přidat pole, na která tato metoda odkazuje.

V případě pole zvolte:

  • Hierarchie obsahu: Přidat hierarchii nadřazeného kontejneru.

  • Odkazující metody: Přidat metody, které odkazují na toto pole.

Zkompilovaná sestavení .NET (.dll nebo .exe) nebo binární soubory

K vyhledání a přetažení položek a vztahů do grafu použijte Průzkumníka architektury.

Přidání propojení mezi existující uzly

  1. Vyberte zdrojový uzel.

    Panel nástrojů se začne zobrazovat nad uzlem.

    Panel nástrojů grafu závislostí

  2. Na panelu nástrojů zvolte možnost Vytvořit nové propojení z tohoto uzlu do kteréhokoli uzlu, do kterého následně kliknetePanel nástrojů grafu - umožňuje vytvořit odkaz.Vyberte cílový uzel.

    Zobrazí se propojení mezi dvěma uzly.

Přidání komentářů do grafu

  1. Vyberte uzel, kam chcete přidat propojené komentáře.

    Panel nástrojů se začne zobrazovat nad uzlem.

    Panel nástrojů grafu závislostí

  2. Na panelu nástrojů zvolte možnost Vytvořit nový uzel komentáře s novým propojením na vybraný uzelPanel nástrojů grafu - umožňuje vytvořit komentář s odkaz.

  3. Zadejte komentáře.Pro psaní na nový řádek stiskněte kombinaci kláves Shift+Enter.

Mazání uzlů

Uzly lze odstranit z grafu, aniž by to ovlivnilo původní kód.Pro odstranění uzlu vyberte uzel a potom stiskněte klávesu Delete.Po odstranění uzlů budou jejich definice odebrány ze souboru DGML (.dgml).

Po odstranění uzlů ze skupiny se uvnitř skupiny zobrazí tlačítko Znovu načíst podřízenéZnovu načíst ikonu děti.Chcete-li získat chybějící uzly, klikněte na tlačítko Znovu načíst podřízenéZnovu načíst ikonu děti.Grafy, které byly vytvořeny úpravou DGML, přidáním nedefinovaných uzlů nebo pomocí dřívější verze systému Visual Studio Ultimate, tuto funkci nepodporují.

Poznámka k upozorněníUpozornění

Před sdílením grafu vytvořeného v systému Visual Studio Ultimate s uživateli používajícími systém Visual Studio Premium nebo Visual Studio Professional se ujistěte, že jsou v grafu viditelné všechny uzly, které mají ostatní uživatele vidět.Jinak tito uživatelé nebudou moci odstraněné uzly načíst.

Seskupování uzlů

Chcete-li

Proveďte tyto kroky

Zobrazení uzlů kontejneru jako uzlů skupin nebo listových uzlů

Chcete-li zobrazit uzly kontejneru jako listové, vyberte uzly.Otevřete místní nabídku pro výběr.Zvolte příkazy Skupina a Převést na list.

Chcete-li zobrazit uzly kontejneru jako uzly skupiny, vyberte uzly.Otevřete místní nabídku pro výběr.Zvolte příkazy Skupina a Převést na skupinu.

Chcete-li zobrazit všechny uzly listů jako uzly skupiny, otevřete místní nabídku grafu.Zvolte příkazy Skupina a Zapnout seskupování.

Chcete-li zobrazit všechny uzly skupiny jako uzly listů, otevřete místní nabídku grafu.Zvolte příkazy Skupina a Vypnout seskupování.

Přidání uzlu do skupiny

Přetáhněte uzel do skupiny.

Uzly lze přetáhnout také mimo skupinu.

Přidání uzlu k uzlu bez skupiny

Na skupinu lze převést libovolný uzel.Přetáhněte uzel na cílový uzel.

Seskupení vybraných uzlů

  1. Vyberte uzly, které chcete seskupit.

    Panel nástrojů se začne zobrazovat nad uzly.

    Panel nástrojů grafu závislostí

  2. Na tomto panelu zvolte příkaz Seskupit vybrané uzlyGraf nástrojů – vybrané skupině.

    - nebo -

    Otevřete místní nabídku pro výběr.Zvolte příkazy Skupina a Přidat nadřazenou skupinu.

  3. Otevřete místní nabídku nové skupiny.Zvolte položku Vlastnosti.Ve vlastnosti Popisek skupinu přejmenujte.

Seskupení uzlů určitých kategorií nebo vlastností

  1. V nabídce Architektura zvolte položku Okna, Průzkumník architektury.

  2. Pomocí Průzkumníka architektury najděte a zvolte všechny uzly, které mají být seskupeny.

    Další informace naleznete v tématu Vyhledávání kódu pomocí Průzkumníka architektury.

  3. Na pravé straně aktuálního sloupce rozbalte sbalený sloupec akce jeho zvolením. (Klávesnice: Přesouvejte zvýraznění klávesou Tab, dokud se sbalený sloupec akce nerozbalí.)

    [!POZNÁMKA]

    Je-li na sloupec akce přesunut ukazatel myši nebo je sloupec vybrán, dojde k jeho zvýraznění.

  4. Ve sloupci akce klikněte na volbu Obsaženo v. (Klávesnice: Klávesou Tab přesuňte zvýraznění a vztah Obsaženo v zvolte pomocí kurzorových šipek.)

  5. Přesuňte do grafu skupiny kontejneru z vedlejšího sloupce.

  6. Otevřete místní nabídku pro graf.Zvolte příkazy Skupina a Zapnout seskupování.

Seskupení uzlů dle hodnot jejich vlastností

  1. Uložte graf na disk jako soubor .dgml.

  2. V nabídce Architektura:Klikněte na volby Windows a Průzkumník architektury.

  3. V Průzkumníku architektury v části Systém souborů zvolte příkaz Vybrat soubory.

  4. V dalším sloupci vyberte uložený soubor .dgml.

  5. Pomocí Průzkumníka architektury najděte a zvolte všechny uzly, které mají být seskupeny.

    Další informace naleznete v tématu Vyhledávání kódu pomocí Průzkumníka architektury.

  6. Na pravé straně aktuálního sloupce rozbalte sbalený sloupec akce jeho zvolením. (Klávesnice: Přesouvejte zvýraznění klávesou Tab, dokud se sbalený sloupec akce nerozbalí.)

    [!POZNÁMKA]

    Je-li na sloupec akce přesunut ukazatel myši, dojde k jeho zvýraznění.

  7. Ve sloupci akce v části Seskupování zvolte příkaz Seskupit dle vlastností. (Klávesnice: Klávesou Tab přesuňte zvýraznění a zvolte příkaz Seskupit dle vlastností pomocí kurzorových šipek.)

  8. V dalším sloupci vyberte vlastnosti, které mají být použity jako skupiny.

    Zobrazí se další sloupec, v němž jsou zobrazeny dostupné hodnoty vlastností.

  9. Přetáhněte z něj skupiny hodnot vlastností do grafu.

  10. Otevřete místní nabídku pro plochu grafu.Zvolte příkazy Skupina a Zapnout seskupování.

Odstranění skupin

Vyberte skupinu nebo skupiny, které mají být odstraněny.Otevřete místní nabídku pro výběr.Zvolte příkazy Skupina a Odstranit skupinu.

Odstranění uzlů z nadřazené skupiny až do druhé úrovně nebo mimo skupinu, nemají-li uzly nadřazenou skupinu druhé úrovně

Vyberte uzly, které mají být odebrány.Otevřete místní nabídku pro výběr.Zvolte příkazy Skupina a Odebrat z nadřazeného.

Seskupení uzlů úpravou souboru .dgml grafu

  1. Chcete-li převést uzel na skupinu, otevřete místní nabídku uzlu.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml a zvýrazní prvek <Node/> patřící tomuto uzlu.

    -nebo-

    Chcete-li přidat novou skupinu:

    1. Otevřete místní nabídku prázdné oblasti v grafu.Zvolte příkazy Přejít a DGML.

    2. V oddílu <Nodes> přidejte nový prvek <Node/>.

  2. Přidáním atributu Group do prvku <Node/> určete, zda se skupina bude zobrazovat rozbalená nebo sbalená.Příklad:

    <Nodes>
       <Node Id="MyFirstGroup" Group="Expanded" />
       <Node Id="MySecondGroup" Group="Collapsed" />
    </Nodes>
    
  3. Ujistěte se v oddílu <Links>, zda v prvku <Link/> existují pro každý vztah mezi uzlem skupiny a podřízenými uzly následující atributy:

    • Atribut Source určující uzel skupiny

    • Atribut Target určující podřízený uzel

    • Atribut Category určující vztah Contains mezi uzlem skupiny a jeho podřízeným uzlem

    Příklad:

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

    Další informace týkající se atributu Category lze nalézt v tématu Přiřazení kategorií uzlům a propojením.

Sloučení grafů

Grafy je možné sloučit kopírováním a vložením uzlů mezi grafy.Pokud se shodují identifikátory uzlů, pak funkce vkládání uzlů odpovídá operaci sloučení.Pro usnadnění tohoto úkolu vložte všechna sestavení nebo binární soubory, které chcete zobrazit, do stejné složky, takže úplná cesta každého sestavení nebo binárního souboru bude pro každý graf, který chcete sloučit, stejná.

Případně lze vytvořit jeden graf pro sestavení nebo binární soubory, které chcete zobrazit, jedním z následujících kroků:

  • Přetáhněte sestavení nebo binární soubory do stejného grafu.

    -nebo-

  • Otevřete Průzkumník architektury.V kategorii Systém souborů zvolte možnost Vybrat soubory, chcete-li procházet, vybrat a otevřít sestavení nebo binární soubory.Pro úpravu grafu vyberte konkrétní položky, které chcete zobrazit.Když skončíte, klikněte na možnost Vytvořit nový dokument grafu ze všech vybraných uzlů na panelu nástrojů Průzkumníka architektury.

Změna stylu grafu

Úpravou souboru .dgml grafu lze změnit barvu pozadí a barvu ohraničení grafu.Více informací o změně stylu uzlů a propojení lze nalézt v oddílu Změna stylu uzlů a propojení.

  1. Otevřete místní nabídku z plochy grafu.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml.

  2. Do prvku <DirectedGraph> přidejte kterýkoli z následujících atributů pro změnu stylu:

    Chcete-li změnit

    Přidejte následující atribut

    Barvu pozadí

    Background="ColorNameOrHexadecimalValue"

    Barvu ohraničení

    Stroke="StrokeValue"

    Příklad:

    <DirectedGraph Background="Green" xmlns="https://schemas.microsoft.com/vs/2009/dgml" >
       ...
       ...
    </DirectedGraph>
    

Změna stylu uzlů a propojení

Lze změnit ikony na uzlech a barvy uzlů a propojení.Lze použít předdefinované barvy a ikony nebo lze zadat vlastní úpravou souboru .dgml grafu.Více informací lze nalézt v oddílu Použití vlastních stylů na uzly a propojení.

Lze například vybrat barvu pro zvýraznění uzlů a propojení, které mají určitou kategorii nebo vlastnost.To umožňuje identifikovat a zaměřit se na určité oblasti grafu.

Použití předdefinované barvy nebo ikony na uzly s konkrétní kategorií nebo vlastností

  1. Pokud není pole Legenda vidět, otevřete místní nabídku grafu.Klikněte na položku Zobrazit legendu.

  2. V poli Legenda se zobrazí, zda se kategorie nebo vlastnost uzlu objeví v seznamu.

  3. Pokud seznam neobsahuje kategorii ani vlastnost, klikněte na symbol + v poli Legenda, na volbu Kategorie uzlu nebo Vlastnost uzlu a na kategorii nebo vlastnost.

    Kategorie nebo vlastnost se nyní zobrazí v poli Legenda.

    [!POZNÁMKA]

    Informace o vytvoření a přidání kategorie uzlu lze nalézt v oddílu Přiřazování kategorií uzlům a propojením.Informace o vytvoření a přidání vlastnosti uzlu lze nalézt v oddílu Přiřazování vlastností uzlům a propojením.

  4. V poli Legenda otevřete rozevírací seznam vedle kategorie nebo vlastnosti.

  5. Pro výběr stylu, který chcete změnit, použijte následující tabulku:

    Chcete-li změnit

    Zvolte

    Barvu pozadí

    Pozadí

    Barva obrysu

    Tah

    Barva textu

    Popředí

    Ikona

    Ikony

    Zobrazí se pole Výběr sady barev pro výběr barvy (nebo ikony).

  6. V dialogovém okně Výběr sady barev proveďte jednu z následujících akcí:

    Chcete-li vybrat

    Proveďte tyto kroky

    Sadu barev (nebo ikon)

    Otevřete seznam Výběr sadybarev (nebo ikon).Vyberte sadu barev (nebo ikon).

    Chcete-li se vrátit k výchozí barvě (nebo ikoně), vyberte v seznamu Výběr sady barev (nebo ikon) položku Žádná.

    Určité barvy (nebo ikony)

    Otevřete seznam hodnot kategorií nebo vlastností.Vyberte barvu (nebo ikonu).

    [!POZNÁMKA]

    V poli Legenda lze styly přeorganizovat, smazat nebo dočasně zakázat.Více informací naleznete v oddílu Úprava pole Legenda.

Použití předdefinované barvy na propojení s konkrétní kategorií nebo vlastností

  1. Pokud není pole Legenda vidět, otevřete místní nabídku grafu.Klikněte na položku Zobrazit legendu.

  2. V poli Legenda zkontrolujte, zda se kategorie nebo vlastnost zobrazuje v seznamu.

  3. Pokud seznam neobsahuje kategorii ani vlastnost, klikněte na symbol + v poli Legenda, na volbu Kategorie propojení nebo Vlastnost propojení a na kategorii či na vlastnost.

    Kategorie nebo vlastnost se nyní zobrazí v poli Legenda.

    [!POZNÁMKA]

    Informace o vytvoření a přidání kategorie propojení lze nalézt v oddílu Přiřazení kategorií uzlům a propojením.Informace o vytvoření a přidání vlastnosti propojení lze nalézt v oddílu Přiřazení vlastností uzlům a propojením.

  4. V poli Legenda otevřete seznam vedle kategorie nebo vlastnosti.

  5. Vyberte volbu Tah pro změnu ohraničení propojení a barvy šipky.

    Zobrazí se pole Výběr sady barev pro výběr barvy.

  6. V poli Výběr sady barev proveďte jednu z následujících akcí:

    Chcete-li vybrat

    Proveďte tyto kroky

    Sada barev

    Otevřete seznam Výběr sadybarev.Vyberte sadu barev.

    Pro návrat k výchozí barvě vyberte ze seznamu Výběr sady barev položku Žádná.

    Určitá barva

    Otevřete seznam hodnot typu nebo vlastnosti a vyberte barvu.

    [!POZNÁMKA]

    V poli Legenda lze styly přeorganizovat, smazat nebo dočasně zakázat.Více informací naleznete v oddílu Úprava pole Legenda.

Použití vlastních stylů na uzly a propojení

Vlastní styly lze použít na následující položky:

  • Jednotlivé uzly a propojení

  • Skupiny uzlů a propojení

  • Skupiny uzlů a propojení na základě určitých podmínek

Aplikace vlastního stylu na jeden uzel

  1. Otevřete místní nabídku uzlu, jehož styl chcete přizpůsobit.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml a zvýrazní prvek <Node/> patřící tomuto uzlu.

  2. Do prvku <Node/> přidejte jakýkoli z následujících atributů pro přizpůsobení stylu:

    Chcete-li změnit

    Přidejte následující atribut

    Barvu pozadí

    Background="ColorNameOrHexadecimalValue"

    Obrys

    Stroke="ColorNameOrHexadecimalValue"

    Tloušťka obrysu

    StrokeThickness="StrokeValue"

    Barva textu

    Foreground="ColorNameOrHexadecimalValue"

    Ikona

    Icon="IconFilePathLocation"

    Velikost textu

    FontSize="FontSizeValue"

    Typ textu

    FontFamily="FontFamilyName"

    Tloušťka textu

    FontWeight="FontWeightValue"

    Styl textu

    FontStyle="FontStyleName"

    Jako styl textu lze například zadat Italic.

    Textura

    Style="Glass"

    - nebo -

    Style="Plain"

    Obrazec

    Pro nahrazení obrazce ikonou nastavte vlastnost Shape na None a vlastnost Icon na cestu umístění souboru s ikonou.

    Shape="ShapeFilePathLocation"

    Příklad:

    <Nodes>
       <Node Id="MyNode" Background="#FF008000" Stroke="#FF000000"
       Foreground="#FFFFFFFF" Icon="...\Icons\Globe.png"/>
    </Nodes>
    

Aplikace vlastního stylu na jedno propojení

  1. V grafu přesuňte ukazatel myši nad propojení.Zobrazí se popis identifikující zdrojový a cílový uzel propojení. (Klávesnice: Mačkejte klávesuTab, dokud se propojení nezvýrazní.)

  2. Otevřete místní nabídku pro graf.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml.

  3. Vyhledejte prvek <Link/>, který obsahuje název zdrojového a cílového uzlu.

  4. Do prvku <Link/> přidejte jakýkoli z následujících atributů pro přizpůsobení stylu:

    Chcete-li změnit

    Přidejte následující atribut

    Barva obrysu a šipky

    Stroke="ColorNameOrHexadecimalValue"

    Tloušťka obrysu

    StrokeThickness="StrokeValue"

    Styl obrysu

    StrokeDashArray="StrokeArrayValues"

    Příklad:

    <Links>
       <Link Source="MyFirstNode" Target="MySecondNode" Background="Green" Stroke="#FF000000" StrokeDashArray="2,2"/>
    </Links>
    

Použití vlastních stylů na skupinu uzlů nebo propojení

  1. Přiřaďte uzlům nebo propojením libovolné kategorie nebo vlastnosti.

    Tip

    Používáte-li opakující se styly napříč mnoha uzly a propojeními, můžete na tyto uzly a propojení použit kategorii a následně na tuto kategorii použít styl.Další informace lze nalézt v oddílech Přiřazení kategorií uzlům a propojením a Přiřazení vlastností uzlům a propojením.

  2. Otevřete místní nabídku pro plochu grafu.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml.

  3. Pokud prvek <Styles></Styles> neexistuje, přidejte jej pod prvek <DirectedGraph></DirectedGraph> za prvek <Links></Links>.

  4. Do prvku <Styles></Styles> pod prvkem <Style/> zadejte následující atributy:

    • TargetType="Node | Link | Graph"

    • GroupLabel="NameInLegendBox"

    • ValueLabel="NameInStylePickerBox"

    Pro použití vlastního stylu na všechny cílové typy nepoužívejte podmínku.

Použití podmíněného stylu na skupiny uzlů nebo propojení

  1. Chcete-li zadat výraz, který vrací logickou hodnotu, přidejte do prvku <Style/> prvek <Condition/>, který obsahuje atribut Expression.

    Příklad:

    <Condition Expression="MyCategory"/>
    

    - nebo -

    <Condition Expression="MyCategory > 100"/>
    

    - nebo -

    <Condition Expression="HasCategory('MyCategory')"/>
    

    Tento výraz používá následující syntaxi BNF (Backus-Naur Form):

    <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> ::= řetězcový literál s jednoduchými nebo dvojitými uvozovkami

    <Number> ::= řetězec číslic s volitelnou desetinnou čárkou

    Lze zadat více prvků <Condition/> , které však musí mít všechny hodnotu true, aby bylo možno styl aplikovat.

  2. Na dalším řádku za prvkem <Condition/>, přidejte jeden nebo více prvků <Setter/>, chcete-li určit atribut Property, a pevný atribut Value nebo vypočítaný atribut Expression, chcete-li je použít na graf, uzly nebo propojení odpovídající podmínce.

    Příklad:

    <Setter Property="BackGround" Value="Green"/>
    

Jednoduchý úplný příklad: Následující podmínka určuje to, že se uzel zobrazí zeleně nebo červeně na základě toho, zda je kategorie Passed nastavena na True nebo 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>

Následující tabulka obsahuje některé ukázkové podmínky, které lze použít:

Chcete-li

Příklad DGML

Nastavení velikosti písma jako funkce počtu řádků kódu, která rovněž změní velikost uzlu.Tento příklad používá jeden podmíněný výraz k nastavení více vlastností FontSize a FontFamily.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
<Nodes>
   <Node Id="Class1" LinesOfCode ="200" />
   <Node Id="Class2" LinesOfCode ="1000" />
   <Node Id="Class3" LinesOfCode ="20" />
</Nodes>
<Properties>
   <Property Id="LinesOfCode" Label="LinesOfCode" Description="LinesOfCode" DataType="System.Int32" />
</Properties>
<Styles>
   <Style TargetType="Node" GroupLabel="LinesOfCode" ValueLabel="Function">
      <Condition Expression="LinesOfCode &gt; 0" />
      <Setter Property="FontSize" Expression="Math.Max(9,Math.Sqrt(LinesOfCode))" />
      <Setter Property="FontFamily" Value="Papyrus" />
   </Style>
</Styles>
</DirectedGraph>

Nastavení barvy pozadí uzlu na základě vlastnosti Coverage.Styly jsou vyhodnocovány v pořadí, ve kterém se zobrazí, podobně jako u příkazů if-else.

V tomto příkladu:

  1. Pokud má vlastnost Coverage hodnotu > 80, pak je vlastnost Background nastavena na zelenou.

  2. Jinak, pokud má vlastnost Coverage hodnotu > 50, pak nastavte vlastnost Background na odstín oranžové na základě hodnoty vlastnosti Coverage.

  3. Jinak nastavte vlastnost Background na odstín červené na základě hodnoty vlastnosti Coverage.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
<Nodes>
   <Node Id="Class1" Coverage="58" />
   <Node Id="Class2" Coverage="95" />
   <Node Id="Class3" Coverage="32" />
</Nodes>
<Properties>
   <Property Id="Coverage" Label="Coverage" Description="Code coverage as a percentage of blocks" DataType="Double" />
</Properties>
<Styles>
   <Style TargetType="Node" GroupLabel="Coverage" ValueLabel="Good">
      <Condition Expression="Coverage &gt; 80" />
      <Setter Property="Background" Value="Green" />
   </Style>
   <Style TargetType="Node" GroupLabel="Coverage" ValueLabel="OK">
      <Condition Expression="Coverage &gt; 50" />
      <Setter Property="Background" Expression="Color.FromRgb(180 * Math.Max(1, (80 - Coverage) / 30), 180, 0)" />
   </Style>
   <Style TargetType="Node" GroupLabel="Coverage" ValueLabel="Bad">
      <Setter Property="Background" Expression="Color.FromRgb(180, 180 * Coverage / 50, 0)" />
   </Style>
</Styles>
</DirectedGraph>

Nastavte vlastnost Shape na None, aby ikona nahradila obrazec.Použijte vlastnost Icon k určení umístění ikony.

<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
<Nodes>
   <Node Id="Automation" Category="Test" Label="Automation" />
   <Node Id="C# Provider" Category="Provider" Label="C# Provider" />
</Nodes>
<Categories>
   <Category Id="Provider" Icon="...\Icons\Module.png" Shape="None" />
   <Category Id="Test" Icon="...\Icons\Page.png" Shape="None" />
</Categories>
<Properties>
   <Property Id="Icon" DataType="System.String" />
   <Property Id="Label" Label="Label" Description="Displayable label of an Annotatable object" DataType="System.String" />
   <Property Id="Shape" DataType="System.String" />
</Properties>
<Styles>
   <Style TargetType="Node" GroupLabel="Group" ValueLabel="Has category">
      <Condition Expression="HasCategory('Group')" />
      <Setter Property="Background" Value="#80008080" />
   </Style>
   <Style TargetType="Node">
      <Setter Property="HorizontalAlignment" Value="Center" />
   </Style>
</Styles>
</DirectedGraph>

Úprava pole Legenda

V poli Legenda lze styly přeorganizovat, smazat nebo dočasně zakázat:

  1. Otevřete místní nabídku pro styl v poli Legenda.

  2. Proveďte některou z následujících úloh:

    Chcete-li

    Zvolte

    Přesunutí stylu nahoru

    Přesunout nahoru

    Přesunutí položky dolů

    Přesunout dolů

    Odstranění položky

    Odstranit

    Deaktivace položky

    Zakázat

    Opětovná aktivace položky

    Povolit

Kopírování stylů z jednoho grafu do jiného

  1. Ujistěte se, že se pole Legenda zobrazí ve zdrojovém grafu.Pokud není zobrazeno, otevřete místní nabídku pro prázdnou oblast zdrojového grafu.Klikněte na položku Zobrazit legendu.

  2. Otevřete místní nabídku pro pole Legenda.Vyberte možnost Kopírovat legendu.

  3. Vložte legendu do cílového grafu.

Přiřazení vlastností uzlům a propojením

Uzly a propojení lze uspořádat přiřazením vlastností.Můžete například vybrat uzly, které mají specifické vlastnosti, takže je lze seskupit, změnit jejich styl nebo je skrýt.

Přiřazení vlastnosti uzlu

  1. Otevřete místní nabídku uzlu.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml a zvýrazní prvek <Node/> patřící tomuto uzlu.

  2. Do prvku <Node/> zadejte název vlastnosti a její hodnotu.Příklad:

    <Nodes>
       <Node Id="MyNode" MyPropertyName="PropertyValue" />
    </Nodes>
    
  3. Přidejte prvek <Property/> do části <Properties> pro zadání atributů, jako je například viditelný název nebo datový typ:

    <Properties>
       <Property Id="MyPropertyName" Label="My Property" DataType="System.DataType"/>
    </Properties>
    

Přiřazení vlastnosti propojení

  1. V grafu přesuňte ukazatel myši nad propojení.Zobrazí se popis identifikující zdrojový a cílový uzel propojení. (Klávesnice: Mačkejte klávesu Tab, dokud se propojení nezvýrazní.)

  2. Otevřete místní nabídku pro graf.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml.

  3. Vyhledejte prvek <Link/>, který obsahuje název zdrojového a cílového uzlu.

  4. Do prvku <Node/> zadejte název vlastnosti a její hodnotu.Příklad:

    <Links>
       <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" />
    </Links>
    
  5. Přidejte prvek <Property/> do části <Properties> pro zadání atributů, jako je například viditelný název nebo datový typ:

    <Properties>
       <Property Id="MyPropertyName" Label="My Property Name" DataType="System.DataType"/>
    </Properties>
    

Přiřazení kategorií uzlům a propojením

Uzly lze uspořádat pomocí přiřazení kategorií.Lze například vybrat uzly, které jsou v určitých kategoriích, takže je lze seskupit, změnit jejich styl nebo je skrýt.Lze zvýraznit propojení, která mají konkrétní kategorie.Další informace lze nalézt v následujících oddílech:

  • Seskupování uzlů

  • Změna stylu uzlů a propojení

  • Skrytí nebo zobrazení uzlů

Přiřazení kategorie uzlu

  • Pro přiřazení předdefinované kategorie, jako je například Kategorie 1, otevřete místní nabídku pro uzel.Zvolte možnost Zařadit do kategorií a zvolte předdefinovanou kategorii.

- nebo -

  • Vytvoření a přiřazení vlastní kategorie:

    • Vyberte uzel, který chcete kategorizovat.Stisknutím klávesy F4 otevřete okno Vlastnosti.Zadejte název kategorie do vlastnosti uzlu Nová kategorie.Stiskněte klávesu ENTER.

    - nebo -

    1. Otevřete místní nabídku uzlu.Zvolte příkazy Přejít a DGML.

      Aplikace Visual Studio otevře soubor grafu .dgml a zvýrazní prvek <Node/> patřící tomuto uzlu.

    2. Do prvku <Node/> přidejte atribut Category pro určení názvu kategorie.Příklad:

      <Nodes>
         <Node Id="MyNode" Category="MyCategory" />
      </Nodes>
      
    3. Do sekce <Categories> přidejte prvek <Category/>, aby bylo možné použít atribut Label pro určení zobrazovaného textu dané kategorie:

      <Categories>
         <Category Id="MyCategory" Label="My Category" />
      </Categories>
      

Přiřazení kategorie propojení

  1. V grafu přesuňte ukazatel myši na propojení, čímž se zobrazí popisek a bude možné identifikovat zdrojový a cílový uzel propojení. (Klávesnice: Mačkejte klávesu Tab, dokud se propojení nezvýrazní.)

  2. Otevřete místní nabídku pro graf.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml.

  3. Vyhledejte prvek <Link/>, který obsahuje název zdrojového a cílového uzlu.

  4. Do prvku <Link/> přidejte atribut Category pro určení názvu kategorie.Příklad:

    <Links>
       <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory"
    </Links>
    
  5. Do sekce <Categories> přidejte prvek <Category/>, aby bylo možné použít atribut Label pro určení zobrazovaného textu dané kategorie:

    <Categories>
       <Category Id="MyCategory" Label="My Category" />
    </Categories>
    

Lze vytvořit hierarchické kategorie pro usnadnění uspořádání uzlů a přidávání atributů do podřízených kategorií pomocí dědičnosti.

Vytvoření hierarchických kategorií

  • Přidejte prvek <Category/> pro nadřazenou kategorii a pak přidejte atribut BasedOn do prvku <Category/> podřízené kategorie.

    Příklad:

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

    V tomto příkladu je pozadí uzlu MyFirstNode zelené, protože jeho atribut Category dědí atribut Background z kategorie MyParentCategory.

Připojení položek k uzlům a propojením

Položky, jako jsou například dokumenty nebo adresy URL, lze připojit k uzlu nebo k propojení úpravou souboru DGML grafu a přidáním atributu Reference do prvku <Node/> v případě uzlu nebo do prvku <Link/> v případě propojení.Tento obsah lze z uzlu nebo propojení následně otevřít a zobrazit.Atribut Reference určuje cestu k obsahu.To může být cesta relativní k umístění souboru .dgml nebo absolutní cesta.

Poznámka k upozorněníUpozornění

Pokud použijete relativní cestu a soubor .dgml bude přesunut do jiného umístění, pak tuto cestu nebude možné interpretovat.Při pokusu o otevření a zobrazení propojeného obsahu, dojde k chybě oznamující, že obsah nelze zobrazit.

Můžete chtít připojit například následující položky:

  • Chcete-li popsat změny třídy, měli byste k uzlu pro třídu připojit adresu URL pracovní položky, dokumentu nebo jiného souboru .dgml.

  • Měli byste připojit diagram vrstvy ke skupinovému uzlu, který reprezentuje vrstvu v logické architektuře softwaru.

  • Pro zobrazení více informací o komponentě, která zpřístupňuje rozhraní, byste měli připojit diagram součásti k uzlu pro dané rozhraní.

  • Připojte uzel k pracovní položce služby Team Foundation Server, chybě nebo jiné informaci, která se vztahuje k uzlu.

Připojení položky k uzlu

  1. V grafu otevřete místní nabídku pro uzel.Zvolte příkazy Přejít a DGML.

    Aplikace Visual Studio otevře soubor grafu .dgml a zvýrazní prvek <Node/> patřící tomuto uzlu.

  2. Proveďte jednu z úloh z následující tabulky:

    Pro připojení

    Proveďte tyto kroky

    Jedné položky

    • V prvku <Node/> nebo <Link/> přidejte atribut Reference k určení umístění položky.

      [!POZNÁMKA]

      Každý prvek může mít pouze jeden atribut Reference.

    Příklad:

    <Nodes>
       <Node Id="MyNode" Reference="MyDocument.txt" />
    </Nodes>
    <Properties>
       <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" />
    </Properties>

    Více položek

    1. V prvku <Node/> nebo <Link/> přidejte nový atribut k určení umístění každého odkazu.

    2. V oddílu <Properties>:

      1. Pro každý nový typ odkazu přidejte prvek <Property/>.

      2. Nastavte atribut Id na název nového atributu odkazu.

      3. Přidejte atribut IsReference a nastavte jej na hodnotu True, chcete-li zajistit, že se odkaz zobrazí v místní nabídce Přejít na položky.

      4. Pro zadání zobrazeného textu v místní nabídce Přejít na položky použijte atribut Label.

    Příklad:

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

    V grafu se zobrazí podtržený název uzlu.Při otevření místní nabídky uzlu nebo propojení se zobrazí místní nabídka Přejít na obsahující připojené položky, ze kterých lze vybírat.

  3. Pro zadání běžného řetězce, jako je například adresa URL, která je použita více odkazy, lze namísto opakovaného zadávání tohoto řetězce do odkazů použít atribut ReferenceTemplate.

    Atribut ReferenceTemplate určuje zástupný symbol pro hodnotu odkazu.V následujícím příkladu bude zástupný symbol {0} v atributu ReferenceTemplate nahrazen hodnotami atributů MyFirstReference a MySecondReference z prvku <Node/>, čímž vznikne úplná cesta.

    <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>
    
  4. Pro zobrazení odkazované položky nebo položek z grafu otevřete místní nabídku pro uzel nebo propojení.Zvolte příkaz Přejít na a poté zvolte položku.

Vytvoření aliasů pro běžně používané cesty

Nahrazení běžně používaných cest aliasy pomáhá zmenšit velikost souboru .dgml a snižuje čas potřebný k načtení nebo uložení souboru.Chcete-li vytvořit alias, přidejte část <Paths></Paths> na konec souboru .dgml.V této části přidejte prvek <Path/>, který chcete definovat jako alias pro cestu:

<Paths>
   <Path Id="MyPathAlias" Value="C:\...\..." />
</Paths>

K odkazování aliasu z prvku v souboru .dgml přidejte k hodnotě Id prvku <Path/> značku dolaru ($) a závorky (()).

<Nodes>
   <Node Id="MyNode" Reference="$(MyPathAlias)MyDocument.txt" />
</Nodes>
<Properties>
   <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" />
</Properties>

Princip jazyka DGML (Directed Graph Markup Language)

Jazyk DGML používá jednoduché značky XML k popisování acyklických a cyklických orientovaných grafů.Orientovaný graf je sada uzlů, které jsou propojeny pomocí propojení neboli hran.Uzly a propojení mohou být použity pro reprezentaci síťových struktur, jako jsou například prvky v softwarovém projektu.Jazyk DGML umožňuje vizualizovat informace, provádět analýzu složitosti nebo jen procházet a upravovat orientované grafy.

Uzly a propojení jsou nazývány prvky grafu nebo jenom prvky.Následující tabulka popisuje typy prvků, které jsou použity v jazyce DGML:

[!POZNÁMKA]

Při úpravách souboru .dgml usnadňuje technologie IntelliSense určení atributů, které jsou k dispozici pro každý prvek, a jejich hodnot.Pro určení barvy v atributu použijte názvy pro běžné barvy, například „Blue“ (modrá) nebo šestnáctkové hodnoty ARGB, jako je například „#ffa0b1c3“.Jazyk DGML používá malou podmnožinu formátů definice barev Windows Presentation Foundation (WPF).Další informace lze nalézt v tématu Třída Barvy.

Prvek

Ukázka

<DirectedGraph></DirectedGraph>

Tento prvek je kořenovým prvkem dokumentu orientovaného grafu (.dgml).V rámci tohoto prvku jsou všechny ostatní prvky jazyka DGML.

Následující seznam popisuje volitelné atributy, které lze vložit:

  • Background – Barva pozadí grafu.

  • BackgroundImage – Umístění souboru obrázku, který bude použit jako pozadí grafu.

  • GraphDirection – Pokud je graf nastaven na stromové rozložení (Sugiyama), uspořádá uzly tak, aby většina propojení směřovala v zadaném směru: TopToBottom, BottomToTop, LeftToRight nebo RightToLeft.Další informace naleznete v tématu Procházení a změna uspořádání grafů závislostí.

  • Layout – Nastaví graf na následující rozložení: None, Sugiyama (stromové rozložení), ForceDirected (rychlé clustery) nebo DependencyMatrix.Další informace naleznete v tématu Procházení a změna uspořádání grafů závislostí.

  • NeighborhoodDistance – Když je graf nastaven na stromové rozložení nebo rychlé clustery, zobrazí pouze ty uzly, které mají zadaný počet (1–7) propojení směřujících z vybraných uzlů.Další informace naleznete v tématu Procházení a změna uspořádání grafů závislostí.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" Background="Blue" xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      ...
   </Nodes>
   <Links>
      ...
   </Links>
   <Categories>
      ...
   </Categories>
   <Properties>
      ...
   </Properties>
</DirectedGraph>

<Nodes></Nodes>

Tento volitelný prvek obsahuje seznam prvků <Node/>, které definují uzly v grafu.Další informace lze nalézt v popisu prvku <Node/>.

[!POZNÁMKA]

Při odkazování nedefinovaného uzlu v prvku <Link/> vytvoří graf prvek <Node/> automaticky.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node ... />
   </Nodes>
   <Links>
      <Link ... />
   </Links>
</DirectedGraph>

<Node/>

Tento prvek definuje jeden uzel.Zobrazí se v seznamu prvků <Nodes><Nodes/>.

Tento prvek musí obsahovat následující atributy:

  • Id – Jedinečný název uzlu a výchozí hodnota atributu Label, pokud není atribut Label zadán zvlášť.Tento název musí odpovídat atributu Source nebo Target propojení, které na něj odkazuje.

Následující seznam popisuje některé volitelné atributy, které lze vložit:

  • Label – Zobrazovaný název uzlu.

  • Atributy stylu.Více informací lze nalézt v oddílu Použití vlastních stylů na uzly a propojení.

  • Category – Název kategorie, který identifikuje prvky sdílející tento atribut.Další informace lze nalézt v popisu prvku <Category/>.

  • Property – Název vlastnosti identifikující prvky, které mají stejnou hodnotu vlastnosti.Další informace lze nalézt v popisu prvku <Property/>.

  • Group – Pokud uzel obsahuje další uzly, nastavte tento atribut na Expanded nebo Collapsed pro zobrazení nebo skrytí jejich obsahu.Musí existovat prvek <Link/>, který obsahuje atribut Category="Contains" a specifikuje nadřazený uzel jako zdrojový uzel a podřízený uzel jako cílový uzel.Více informací lze nalézt v oddílu Uspořádání uzlů do skupin.

  • Visibility – Tento atribut nastavte na Visible, Hidden nebo Collapsed.Používá System.Windows.Visibility.Více informací lze nalézt v oddílu Skrývání nebo zobrazování uzlů.

  • Reference – Nastavte tento atribut na připojení k dokumentu nebo adrese URL.Více informací lze nalézt v oddílu Připojení položek k uzlům.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="Driver" Label="Student" Category="Person" />
      <Node Id="Passenger" Label="Instructor" Category="Person" />
      <Node Id="Car" Label="Car" Category="Automobile" />
      <Node Id="Truck" Label="Truck" Category="Automobile" />
   </Nodes>
   <Links>
      <Link ... />
   </Links>
   <Categories>
      <Category Id="Person" Background="Orange" />
      <Category Id="Automobile" Background="Yellow"/>
   </Categories>
</DirectedGraph>

<Links></Links>

Tento prvek obsahuje seznam prvků <Link>, které definují propojení mezi uzly.Další informace lze nalézt v popisu prvku <Link/>.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Links>
      <Link ... />
   </Links>
</DirectedGraph>

<Link/>

Tento prvek definuje jedno propojení, které připojuje zdrojový uzel k cílovému uzlu.Zobrazí se v seznamu prvků <Links></Links>.

[!POZNÁMKA]

Pokud tento prvek odkazuje na nedefinovaný uzel, pak dokument grafu automaticky vytvoří uzel, který má zadané atributy, pokud existují.

Tento prvek musí obsahovat následující atributy:

  • Source – Zdrojový uzel propojení

  • Target – Cílový uzel propojení

Následující seznam popisuje některé volitelné atributy, které lze vložit:

  • Label – Zobrazované jméno propojení

  • Atributy stylu.Více informací lze nalézt v oddílu Použití vlastních stylů na uzly a propojení.

  • Category – Název kategorie, který identifikuje prvky sdílející tento atribut.Další informace lze nalézt v popisu prvku <Category/>.

  • Property – Název vlastnosti identifikující prvky, které mají stejnou hodnotu vlastnosti.Další informace lze nalézt v popisu prvku <Property/>.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="Driver" Label="Student" Category="Person" />
      <Node Id="Passenger" Label="Instructor" Category="Person" />
      <Node Id="Car" Label="Car" Category="Automobile" />
      <Node Id="Truck" Label="Truck" Category="Automobile" />
   </Nodes>
   <Links>
      <Category Id="Person" Background="Orange" />
      <Category Id="Automobile" Background="Yellow"/>
      <Link Source="Driver" Target="Car" Label="Passed" Stroke="Black" Background="Green" Category="PassedTest" />
      <Link Source="Driver" Target="Truck" Label="Failed" Stroke="Black" Background="Red" Category="PassedTest" />
   </Links>
</DirectedGraph>

<Categories></Categories>

Tento prvek obsahuje seznam prvků <Category/>.Další informace lze nalézt v popisu prvku <Category/>.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Categories>
       <Category ... />
   </Categories>
</DirectedGraph>

<Category/>

Tento prvek definuje atribut Category, který slouží k identifikaci prvků, jež tento atribut sdílí.Atribut Category lze použít k uspořádání prvků grafu, poskytování sdílených atributů prostřednictvím dědičnosti nebo definování dalších metadat.

Tento prvek musí obsahovat následující atributy:

  • Id – Jedinečný název kategorie a výchozí hodnota atributu Label, pokud není atribut Label zadán zvlášť.

Následující seznam popisuje některé volitelné atributy, které lze vložit:

  • Label – Popisný název kategorie.

  • BasedOn – Nadřazená kategorie, ze které prvek <Category/> aktuálního prvku dědí.

    V příkladu tohoto prvku kategorie FailedTest dědí atribut Stroke z kategorie PassedTest.Více informací lze nalézt v části zabývající se vytvořením hierarchických kategorií v oddílu Přiřazení kategorií uzlům a propojením.

Kategorie rovněž poskytují některé základní šablony chování, které řídí vzhled uzlů a propojení zobrazených v grafu.Více informací lze nalézt v oddílu Použití vlastních stylů na uzly a propojení.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="Driver" Label="Driver" Category="Person" />
      <Node Id="Car" Label="Car" Category="Automobile" />
      <Node Id="Truck" Label="Truck" Category="Automobile" />
      <Node Id="Passenger" Category="Person" />
   </Nodes>
   <Links>
      <Link Source="Driver" Target="Car" Label="Passed" Category="PassedTest" />
      <Link Source="Driver" Target="Truck" Label="Failed" Category="FailedTest" />
   </Links>
   <Categories>
      <Category Id="Person" Background="Orange" />
      <Category Id="Automobile" Background="Yellow"/>
      <Category Id="PassedTest" Label="Passed" Stroke="Black" Background="Green" />
      <Category Id="FailedTest" Label="Failed" BasedOn="PassedTest" Background="Red" />
   </Categories>
</DirectedGraph>

<Properties></Properties>

Tento prvek obsahuje seznam prvků <Property/>.Další informace lze nalézt v popisu prvku <Property/>.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Properties>
       <Property ... />
   </Properties>
</DirectedGraph>

<Property/>

Tento prvek definuje atribut Property, který umožňuje přiřadit hodnotu každému prvku nebo atributu jazyka DGML, včetně kategorií a dalších vlastností.

Tento prvek musí obsahovat následující atributy:

  • Id – Jedinečný název vlastnosti a výchozí hodnota atributu Label, pokud není atribut Label zadán zvlášť.

  • DataType – Typ dat uložených ve vlastnosti

Aby se vlastnost zobrazila v okně Vlastnosti, použijte vlastnost Label k zadání zobrazovaného názvu vlastnosti.

Více informací lze nalézt v oddílu Přiřazení vlastností uzlům a propojením.

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="Driver" Label="Driver" Category="Person" DrivingAge="18"/>
      <Node Id="Car" Label="Car" Category="Automobile" />
      <Node Id="Truck" Label="Truck" Category="Automobile" />
      <Node Id="Passenger" Category="Person" />
   </Nodes>
   <Links>
      <Link Source="Driver" Target="Car" Label="Passed" Category="PassedTest" />
      <Link Source="Driver" Target="Truck" Label="Failed" Category="FailedTest" />
   </Links>
   <Categories>
      <Category Id="Person" Background="Orange" />
      <Category Id="Automobile" Background="Yellow"/>
      <Category Id="PassedTest" Label="Passed" Stroke="Black" Background="Green" />
      <Category Id="FailedTest" Label="Failed" BasedOn="PassedTest" Background="Red" />
   </Categories>
   <Properties>
       <Property Id="DrivingAge" Label="Driving Age" DataType="System.Int32" />
   </Properties>
</DirectedGraph>

Viz také

Koncepty

Mapování závislostí ve vašem kódu v grafech závislostí

Procházení a změna uspořádání grafů závislostí