Ú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
Visual Studio Ultimate, Visual Studio Premium a Visual Studio Professional
Chcete-li vytvořit grafy závislostí, je zapotřebí mít aplikaci Visual Studio Ultimate.Další informace naleznete v tématu Mapování závislostí ve vašem kódu v grafech závislostí.
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ů:
|
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ě.
![]() |
---|
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ů |
|
Skrytí nevybraných uzlů |
|
Zobrazení skrytých uzlů |
|
Skrytí uzlů úpravou souboru .dgml |
|
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 |
|
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í |
|
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:
V případě třídy zvolte:
V případě metody zvolte:
V případě pole zvolte:
|
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
Vyberte zdrojový uzel.
Panel nástrojů se začne zobrazovat nad uzlem.
Na panelu nástrojů zvolte možnost Vytvořit nové propojení z tohoto uzlu do kteréhokoli uzlu, do kterého následně kliknete
.Vyberte cílový uzel.
Zobrazí se propojení mezi dvěma uzly.
Přidání komentářů do grafu
Vyberte uzel, kam chcete přidat propojené komentáře.
Panel nástrojů se začne zobrazovat nad uzlem.
Na panelu nástrojů zvolte možnost Vytvořit nový uzel komentáře s novým propojením na vybraný uzel
.
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é.Chcete-li získat chybějící uzly, klikněte na tlačítko Znovu načíst podřízené
.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í.
![]() |
---|
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ů |
|
Seskupení uzlů určitých kategorií nebo vlastností |
|
Seskupení uzlů dle hodnot jejich vlastností |
|
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
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:
Otevřete místní nabídku prázdné oblasti v grafu.Zvolte příkazy Přejít a DGML.
V oddílu <Nodes> přidejte nový prvek <Node/>.
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>
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í.
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.
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í
Pokud není pole Legenda vidět, otevřete místní nabídku grafu.Klikněte na položku Zobrazit legendu.
V poli Legenda se zobrazí, zda se kategorie nebo vlastnost uzlu objeví v seznamu.
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.
V poli Legenda otevřete rozevírací seznam vedle kategorie nebo vlastnosti.
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).
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í
Pokud není pole Legenda vidět, otevřete místní nabídku grafu.Klikněte na položku Zobrazit legendu.
V poli Legenda zkontrolujte, zda se kategorie nebo vlastnost zobrazuje v seznamu.
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.
V poli Legenda otevřete seznam vedle kategorie nebo vlastnosti.
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.
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
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.
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í
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í.)
Otevřete místní nabídku pro graf.Zvolte příkazy Přejít a DGML.
Aplikace Visual Studio otevře soubor grafu .dgml.
Vyhledejte prvek <Link/>, který obsahuje název zdrojového a cílového uzlu.
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í
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.
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.
Pokud prvek <Styles></Styles> neexistuje, přidejte jej pod prvek <DirectedGraph></DirectedGraph> za prvek <Links></Links>.
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í
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.
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:
Úprava pole Legenda
V poli Legenda lze styly přeorganizovat, smazat nebo dočasně zakázat:
Otevřete místní nabídku pro styl v poli Legenda.
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
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.
Otevřete místní nabídku pro pole Legenda.Vyberte možnost Kopírovat legendu.
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
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.
Do prvku <Node/> zadejte název vlastnosti a její hodnotu.Příklad:
<Nodes> <Node Id="MyNode" MyPropertyName="PropertyValue" /> </Nodes>
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í
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í.)
Otevřete místní nabídku pro graf.Zvolte příkazy Přejít a DGML.
Aplikace Visual Studio otevře soubor grafu .dgml.
Vyhledejte prvek <Link/>, který obsahuje název zdrojového a cílového uzlu.
Do prvku <Node/> zadejte název vlastnosti a její hodnotu.Příklad:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" /> </Links>
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 -
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.
Do prvku <Node/> přidejte atribut Category pro určení názvu kategorie.Příklad:
<Nodes> <Node Id="MyNode" Category="MyCategory" /> </Nodes>
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í
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í.)
Otevřete místní nabídku pro graf.Zvolte příkazy Přejít a DGML.
Aplikace Visual Studio otevře soubor grafu .dgml.
Vyhledejte prvek <Link/>, který obsahuje název zdrojového a cílového uzlu.
Do prvku <Link/> přidejte atribut Category pro určení názvu kategorie.Příklad:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory" </Links>
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.
![]() |
---|
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
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.
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
V prvku <Node/> nebo <Link/> přidejte nový atribut k určení umístění každého odkazu.
V oddílu <Properties>:
Pro každý nový typ odkazu přidejte prvek <Property/>.
Nastavte atribut Id na název nového atributu odkazu.
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.
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.
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>
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:
|
|
<Nodes></Nodes> Tento volitelný prvek obsahuje seznam prvků <Node/>, které definují uzly v grafu.Další informace lze nalézt v popisu prvku <Node/>.
|
|
<Node/> Tento prvek definuje jeden uzel.Zobrazí se v seznamu prvků <Nodes><Nodes/>. Tento prvek musí obsahovat následující atributy:
Následující seznam popisuje některé volitelné atributy, které lze vložit:
|
|
<Links></Links> Tento prvek obsahuje seznam prvků <Link>, které definují propojení mezi uzly.Další informace lze nalézt v popisu prvku <Link/>. |
|
<Link/> Tento prvek definuje jedno propojení, které připojuje zdrojový uzel k cílovému uzlu.Zobrazí se v seznamu prvků <Links></Links>.
Tento prvek musí obsahovat následující atributy:
Následující seznam popisuje některé volitelné atributy, které lze vložit:
|
|
<Categories></Categories> Tento prvek obsahuje seznam prvků <Category/>.Další informace lze nalézt v popisu prvku <Category/>. |
|
<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:
Následující seznam popisuje některé volitelné atributy, které lze vložit:
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í. |
|
<Properties></Properties> Tento prvek obsahuje seznam prvků <Property/>.Další informace lze nalézt v popisu prvku <Property/>. |
|
<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:
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. |
|