Editar e personalizar gráficos de dependência
Você pode editar elementos gráficos de dependência sem afetar o código subjacente.Isso é útil quando você deseja se concentra em itens principais ou para comunicar exibições sobre o código.Por exemplo, para realçar áreas interessantes, você pode selecionar nós e filtrar-los, altere o estilo de nós e links, o couro cru ou os nós delete, e organizar nós usando propriedades, categorias, ou grupos.
Você pode personalizar um gráfico mesmo adicional editando o arquivo direcionado de linguagem de marcação de gráfico de gráfico (.dgml).Por exemplo, você pode editar elementos para especificar estilos personalizados, para atribuir propriedades e categorias nós e links, ou nós de link para itens, como documentos, URL, ou outros elementos gráficos.
.gif "Observação") Observação |
|---|
O Visual Studio limpa todos os elementos não usadas e atributos de DGML excluindo os quando você salvar o arquivo de .dgml.Também cria elementos de nós automaticamente quando você adicionar manualmente os novos links. Quando você salvar o arquivo de .dgml, todos os atributos que você adicionasse a um elemento podem reorganizar-se em ordem alfabética.Para obter mais informações sobre os elementos de DGML, consulte Linguagem de marcação direcionada compreensão (DGML) chart. |
Requisitos
Visual Studio Ultimate, Visual Studio Premium ou Visual Studio Professional
Para criar gráficos de dependência, você deve ter o Visual Studio final.Consulte Visualizar dependências de código em gráficos de dependência.
Neste tópico
Selecione nós ou links
Renomear nós ou links
Ocultar ou exibir nós e links
Adicionar nós e links
Adicionar comentários para o gráfico
Excluir nós
Nós agrupar
Mesclar gráficos
Alterar o estilo de gráfico
Alterar o nó ou vincular o estilo
Copiar estilos de um gráfico para outro gráfico
Atribuir propriedades nós e a links
Atribuir categorias a nós e a links
Vincule itens nós ou para links
Criar alias para caminhos de uso geral
Selecione nós ou links
Para |
Executar estas etapas |
|---|---|
Selecione todos os nós de-selecionados |
Abra o menu de atalho para os nós selecionados.Escolha Selecionar, Inverter seleção. |
Selecione os nós adicionais que vinculam a selecionados |
Abra o menu de atalho para os nós selecionados.Escolha Selecionar e um destes procedimentos:
|
Renomear nós ou links
Selecione o nó ou o link.Pressione F2.Quando a caixa de edição aparece, renomeie o nó ou do link.
Se o rótulo é visível, selecione o rótulo.
Ocultar ou exibir nós e links
Ocultando nós manter-los de participação em algoritmos de layout.Por padrão, os links entre grupo são ocultos.Links entre grupo são links individuais conectando nós através de grupos.Quando os grupos são recolhidos, o gráfico agrega todos os links do grupo cruzado nos únicos links entre grupos.Quando você expandir um grupo e um nós selecionados dentro do grupo, os links do grupo cruzado aparecem e mostram as dependências no grupo.
.gif "Observação de cuidado") Cuidado |
|---|
Antes de compartilhar um gráfico criado no Visual Studio Ultimate com aqueles que usam o Visual Studio Premium ou o Visual Studio Professional, certifique-se de re-exibir quaisquer nós ou links entre grupos que deseja serem visualizados por outras pessoas.Se não, os usuários poderão reexibir esses itens. |
Para ocultar ou exibir nós
Para |
Executar estas etapas |
|---|---|
Nós selecionados couro cru |
|
Ocultar nós de-selecionados |
|
Mostrar os nós ocultos |
|
Ocultar nós editando o arquivo de .dgml |
|
.gif "Reexibir o ícone de filhos")
filho no canto superior esquerdo do grupo.Para mostrar ou ocultar os links
Para |
Na barra de ferramentas do gráfico, abra a lista de Alterar como links são processados no gráfico ou abra o menu de atalho do gráfico. Escolha: |
|---|---|
Mostrar os links do grupo cruzado em todas as vezes |
Mostrar todos os links entre grupo Isso oculta links agregados entre grupos. |
Mostrar somente links entre grupo para nós selecionados |
Mostrar os links do grupo cruzado em nós selecionados |
Ocultar os links do grupo cruzado em todas as vezes |
Ocultar os links entre grupo |
Ocultar todos os links (ou mostrar todos os links) |
Ocultar todos os links Para mostrar todos os links, escolha Ocultar todos os links novamente para desativar esse modo. |
Adicionar nós e links
Para adicionar um novo nó indefinido |
Executar estas etapas |
|---|---|
No local atual do ponteiro |
Selecione um local no gráfico onde colocar o novo nó.Pressione Inserir. |
Esse links para o nó selecionado |
|
Esse vincula a um nó existente com foco atual |
Pressione Tabulação até o nó a que você deseja vincular tem o foco.PressioneShift+ ALT+Inserir. |
.gif "Barra de ferramentas de gráfico - criar o nó com link")
.Para adicionar nós para |
Executar estas etapas |
|---|---|
Itens no solution |
|
Itens relacionados aos nós no gráfico |
Abra o menu de atalho para o nó.Escolha Mostrar e o tipo de relacionamento que você interesses. Para um assembly, escolha:
Para uma classe, escolha:
Para um método, escolha:
Para um campo, escolha:
|
Módulos compilados .NET (.dll ou .exe) ou binários |
Use Arquitetura Explorer para localizar e arraste itens e relacionamentos para o gráfico. |
Para adicionar um link entre nós existentes
Selecione o nó de origem.
Iniciar uma barra de ferramentas para aparecer acima do nó.
.png "Barra de ferramentas de gráfico de dependência")
Na barra de ferramentas, escolha Criar novo link deste nó para qualquer nó que você clicar em seguida
.gif "Barra de ferramentas de gráfico - criar vínculo")
.Selecione o nó de destino.Um link aparece entre os dois nós.
Adicionar comentários para o gráfico
Selecione o nó onde você deseja adicionar um comentário associado.
Iniciar uma barra de ferramentas para aparecer acima do nó.
Na barra de ferramentas, escolha Crie um novo nó de comentário com um novo link para o nó selecionado
.png "Barra de ferramentas de gráfico - criar comentário com link")
.Digite seus comentários.Para digitar em uma nova linha, pressione SHIFT+Enter.
Excluir nós
Você pode excluir nós de um gráfico sem afetar o código subjacente.Para excluir um nó, selecione o nó, e pressione a tecla de Excluir .Quando você exclui nós, suas definições são removidas de arquivo de DGML (.dgml).
Quando você exclui nós de um grupo, o botão .png "Buscar novamente o ícone de filhos")
de Filhos de Refetch aparece no grupo.Para recuperar nós ausente, escolha Nova Busca de Filhos.Os gráficos que são criados editando o DGML, adicionando nós indefinidas, ou usando as versões anteriores do Visual Studio finais, não suportam este recurso.
| Cuidado |
|---|
Antes de compartilhar um gráfico que foi criado usando o Visual Studio Ultimate com aqueles que usam o Visual Studio Premium ou o Visual Studio Professional, certifique-se de que quaisquer nós que você deseja que outros vejam estejam visíveis no gráfico.Se não, os usuários poderão recuperar nós excluídos. |
Nós agrupar
Para |
Executar estas etapas |
|---|---|
Mostrar os nós de contêiner como nós ou nós folha do grupo |
Para mostrar os nós de contêiner como nós folha, selecione os nós.Abra o menu de atalho para a seleção.Escolha Grupo, Converter a folhear. Para mostrar os nós de recipiente como nós de grupo, selecione os nós.Abra o menu de atalho para a seleção.Escolha Grupo, Converter em Grupo. Para mostrar todos os nós folha como nós de grupo, abra o menu de atalho para o gráfico.Escolha Grupo, Ativar o agrupamento. Para mostrar todos os nós de grupo como nós folha, abra o menu de atalho para o gráfico.Escolha Grupo, Desativar o agrupamento. |
Adicione um nó para um grupo |
Arraste o nó no grupo. Você também pode arrastar nós fora de um grupo. |
Adicione um nó em um nó que não são de grupo |
Você pode converter qualquer nó em um grupo.Arraste o nó no nó de destino. |
Agrupar nós selecionados |
|
Agrupar os nós que têm categorias ou propriedades específicas |
|
Agrupar nós de acordo com os valores de propriedade |
|
Remova os grupos |
Selecione o grupo ou grupos que você deseja remover.Abra o menu de atalho para a seleção.Escolha Grupo, Remover Grupo. |
Remover os nós do grupo pai até o avô, ou para fora do grupo, se não têm nenhum grupo de avô |
Selecione os nós que você deseja mover.Abra o menu de atalho para a seleção.Escolha Grupo, Remova pai. |
.gif "Ferramentas de gráfico - grupo selecionado")
.Para agrupar nós editando o arquivo gráfico de .dgml
Para converter um nó para um grupo, abra o menu de atalho para o nó.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.
- ou -
Para adicionar um novo grupo:
Abra o menu de atalho para uma área em branco de gráfico.Escolha Ir para, DGML.
Na seção de <Nodes> , adicione um novo elemento de <Node/> .
No elemento de <Node/> , adicione um atributo de Group para especificar se o grupo é expandido ou recolhido.Por exemplo:
<Nodes> <Node Id="MyFirstGroup" Group="Expanded" /> <Node Id="MySecondGroup" Group="Collapsed" /> </Nodes>Na seção de <Links> , certifique-se de que um elemento de <Link/> que tem os seguintes atributos existir para cada relacionamento entre um nó de grupo e seus nós filho:
Um atributo de Source que especifica o nó do grupo
Um atributo de Target que especifica o nó filho
Um atributo de Category que especifica uma relação de Contains entre o nó de grupo e o nó filho
Por exemplo:
<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>Para obter mais informações sobre o atributo de Category , consulte Atribuir categorias a nós e a links.
Mesclar gráficos
Você pode mesclar gráficos copiar e colar nós entre elementos gráficos.Se os identificadores de nó coincidirem, então cole nós funciona como uma operação de mesclagem.Para facilitar essa tarefa, coloque todos os assemblies ou binários que você deseja visualizar na mesma pasta de modo que o caminho completo de cada assembly ou binária é o mesmo para cada elemento gráfico que você deseja mesclar.
Como alternativa, você pode criar um único elemento gráfico para assemblies ou os binários que você deseja visualizar seguindo um dessas etapas:
Arraste conjuntos os binários ou ao mesmo gráfico.
- ou -
Arquitetura Exploreraberto.Em Sistema de arquivos, escolha Selecionar Arquivos para procurar, selecione, e abrir assemblies ou os binários.Para refinar o gráfico, selecione os itens específicos que você deseja visualizar.Quando você terminar, escolha Crie um novo documento de gráfico de todos os nós selecionados na barra de ferramentas Arquitetura Explorer .
Alterar o estilo de gráfico
Você pode alterar a cor do plano de fundo e limitar a cor do gráfico editando o arquivo de .dgml de gráfico.Para alterar o estilo de nós e os links, consulte Alterar o estilo de nós e os links.
Abra o menu de atalho da superfície do gráfico.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico.
No elemento de <DirectedGraph> , adicione alguns dos seguintes atributos para alterar o estilo:
Para alterar
Adicione o seguinte atributo
Cor do plano de fundo
Background="ColorNameOrHexadecimalValue"Cor da borda
Stroke="StrokeValue"Por exemplo:
<DirectedGraph Background="Green" xmlns="https://schemas.microsoft.com/vs/2009/dgml" > ... ... </DirectedGraph>
Alterar o estilo de nós e os links
Você pode alterar os ícones de nós e as cores de nós e os links.Você pode usar cores e ícones predefinidos, ou você pode especificar utilizar um editando o arquivo de .dgml de gráfico.Consulte Aplicar estilos personalizados para nós e a links.
Por exemplo, você pode escolher uma cor para realçar os nós e links que têm uma determinada categoria ou propriedade.Isso permite que você identificar e focalizar áreas específicas do gráfico.
Para aplicar uma cor ou um ícone predefinido nós com uma determinada categoria ou propriedade
Se a caixa de Legenda não estiver visível, abra o menu de atalho para o gráfico.Escolha Mostrar Legenda.
Na caixa de Legenda , verifique se a categoria ou propriedade do nó aparecem na lista.
Se a lista não inclui a categoria ou a propriedade, escolha + na caixa de Legenda , Categoria do nó ou Propriedade do nó, e a categoria ou propriedade.
A categoria ou a propriedade agora aparecem na caixa de Legenda .
ObservaçãoPara criar e atribuir uma categoria a um nó, consulte Atribuir categorias a nós e a links.Para criar e atribuir uma propriedade em um nó, consulte Atribuir propriedades nós e a links.
Na caixa de Legenda , abra a lista suspensa próxima de categoria ou propriedade.
Use a tabela a seguir para selecionar o estilo que você deseja modificar:
Para alterar
Choose
Cor do plano de fundo
Plano de fundo
Outline a cor
Traço
Cor do texto
Primeiro plano
Ícone
Ícones
A caixa do O selecionador de cores ajustada parece que você selecione uma cor (ou o ícone).
Na caixa de diálogo O selecionador de cores ajustada , execute um destes procedimentos:
Para aplicar a
Executar estas etapas
Conjunto de cores (ou de ícones
Abra a lista de Selecionar Cor (ou ícone) conjunto .Selecione um conjunto de cores (ou de ícones).
Para reverter para a cor padrão (ou o ícone), na lista de conjunto Selecionar Cor (ícone), escolha Nenhum.
Cor específica (ou ícone)
Abra a lista de categorias ou de valor de propriedade.Selecione uma cor (ou o ícone).
ObservaçãoVocê pode reorganizar, excluir, ou desativar temporariamente estilos na caixa de Legenda .Consulte Modifique a caixa de legenda.
Para aplicar uma cor predefinido para links com uma determinada categoria ou propriedade
Se a caixa de Legenda não estiver visível, abra o menu de atalho para o gráfico.Escolha Mostrar Legenda.
Na caixa de Legenda , verifique se a categoria ou a propriedade aparecem na lista.
Se a lista não inclui a categoria ou a propriedade, escolha + na caixa de Legenda , Categoria de link ou Propriedade de link, e a categoria ou propriedade.
A categoria ou a propriedade agora aparecem na caixa de Legenda .
ObservaçãoPara criar e atribuir uma categoria a um link, consulte Atribuir categorias a nós e a links.Para criar e atribuir uma propriedade para um link, consulte Atribuir propriedades nós e a links.
Na caixa de Legenda , abra a caixa de listagem ao lado da categoria ou propriedade.
Selecione Traço para alterar o contorno de link e cor de seta.
A caixa do O selecionador de cores ajustada parece que você selecione uma cor.
Na caixa do O selecionador de cores ajustada , execute um destes procedimentos:
Para aplicar a
Executar estas etapas
Conjunto de cores
Abra a lista de Selecionar Corconjunto .Selecione um conjunto de cores.
Para reverter para a cor padrão, na lista de Selecionar conjunto de cores , escolha Nenhum.
Cor específica
Abra a lista de tipo ou de valor de propriedade para selecionar uma cor.
ObservaçãoVocê pode reorganizar, excluir, ou desativar temporariamente estilos na caixa de Legenda .Consulte Modifique a caixa de legenda.
.gif "Ee842619.collapse_all(pt-br,VS.110).gif")
Aplicar estilos personalizados para nós e a links
Você pode aplicar personalizados para os seguintes itens:
Nós únicos e links
Grupos de nós e links
Grupos de nós e links com base em determinadas condições
Para aplicar um estilo personalizado a um único nó
Abra o menu de atalho para o nó cujo estilo você deseja personalizar.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.
No elemento de <Node/> , adicione alguns dos seguintes atributos para personalizar o seu estilo:
Para alterar
Adicione o seguinte atributo
Cor do plano de fundo
Background="ColorNameOrHexadecimalValue"Estrutura
Stroke="ColorNameOrHexadecimalValue"Espessura de estrutura
StrokeThickness="StrokeValue"Cor do texto
Foreground="ColorNameOrHexadecimalValue"Ícone
Icon="IconFilePathLocation"Tamanho do texto
FontSize="FontSizeValue"Tipo de texto
FontFamily="FontFamilyName"Peso de texto
FontWeight="FontWeightValue"Estilo de texto
FontStyle="FontStyleName"Por exemplo, você pode especificar Italic como o estilo de texto.
Textura
Style="Glass"- ou -
Style="Plain"Forma
Para substituir a forma com um ícone, defina a propriedade de Shape a None e defina a propriedade de Icon o caminho com o arquivo de ícone.
Shape="ShapeFilePathLocation"Por exemplo:
<Nodes> <Node Id="MyNode" Background="#FF008000" Stroke="#FF000000" Foreground="#FFFFFFFF" Icon="...\Icons\Globe.png"/> </Nodes>
Para aplicar um estilo personalizado a um único link
O elemento gráfico, mova o ponteiro do mouse sobre o link.Uma ferramenta de dica aparece e identifica o nó de origem e o nó de destino do link.(Teclado: PressioneTab até o foco estiver no link.)
Abra o menu de atalho para o gráfico.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico.
Localize o elemento de <Link/> que contém os dois nomes de nó de origem e o nó de destino.
No elemento de <Link/> , adicione alguns dos seguintes atributos para personalizar o seu estilo:
Para alterar
Adicione o seguinte atributo
Estrutura e cor da seta
Stroke="ColorNameOrHexadecimalValue"Espessura de estrutura
StrokeThickness="StrokeValue"Estilo de estrutura
StrokeDashArray="StrokeArrayValues"Por exemplo:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Background="Green" Stroke="#FF000000" StrokeDashArray="2,2"/> </Links>
Para aplicar estilos personalizados a um grupo de nós ou de links
Atribuir todas as categorias ou propriedades que você desejar nós ou para links.
DicaSe você tiver repita estilos entre vários nós ou links, você pode considerar aplicar uma categoria 2 os nós ou links, e então aplicar um estilo a essa categoria.Para obter mais informações, consulte Atribuir categorias a nós e a links e Atribuir propriedades nós e a links.
Abra o menu de atalho para a superfície de gráfico.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico.
Se um elemento de <Styles></Styles> não existir, adicione um sob o elemento de <DirectedGraph></DirectedGraph> após o elemento de <Links></Links> .
No elemento de <Styles></Styles> , no elemento de <Style/> e especificar os seguintes atributos:
TargetType="Node | Link | Graph"
GroupLabel="NameInLegendBox"
ValueLabel="NameInStylePickerBox"
Para aplicar um estilo personalizado para todos os tipos de destino, não use uma condição.
Para aplicar um estilo condicional grupos de nós ou de links
No elemento de <Style/> , adicione um elemento de <Condition/> que contém um atributo de Expression para especificar uma expressão que retorna um valor Booleano.
Por exemplo:
<Condition Expression="MyCategory"/>- ou -
<Condition Expression="MyCategory > 100"/>- ou -
<Condition Expression="HasCategory('MyCategory')"/>Esta expressão usa a seguinte sintaxe de (BNF) de forma de formato Backus-Naur:
::= <BinaryExpression> de<Expression> | <UnaryExpression> | “(“")”<Expression>| <MemberBindings> | <Literal> | <Number>
::= <Expression> <Operator> <Expression>de<BinaryExpression>
<UnaryExpression> ::= "!" <Expression> | “+” <Expression> | “-” <Expression>
<Operator> ::= "<" | "<=" | "=" | ">=" | ">" | "!=" | "or" | "and" | "+" | "*" | "/" | "-"
::= <MemberBindings> de<MemberBindings> | <MemberBinding> “.” <MemberBinding>
::= <MethodCall> de<MemberBinding> | <PropertyGet>
::= <Identifier> de<MethodCall> “(” ")” <MethodArgs>
identificador de ::= de<PropertyGet>
::= <Expression> de<MethodArgs> | <Expression> “,” <MethodArgs> | <empty>
::= de<Identifier> [^.]*
literal de citado de ::= de<Literal> único ou de cadeia de caracteres
cadeia de caracteres de ::= de<Number> de dígitos com ponto decimal opcional
Você pode especificar vários elementos de <Condition/>, que elas devem todas ser verdadeiros aplicar o estilo.
Na próxima linha após o elemento de <Condition/> , adicionar um ou vários elementos de <Setter/> para especificar um atributo de Property e um atributo fixo de Value ou um atributo computado de Expression para aplicar o gráfico, nós, ou para links que atendem a condição.
Por exemplo:
<Setter Property="BackGround" Value="Green"/>
Como um exemplo completo simples, a condição a seguir especifica que um nó aparece verde ou vermelho com base em se sua categoria de Passed é definida como True ou a 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>
A tabela a seguir inclui um exemplo condiciona que você pode usar:
Modifique a caixa de legenda
Você pode reorganizar, excluir, ou desativar temporariamente estilos na caixa de Legenda :
Abra o menu de atalho para um estilo na caixa de Legenda .
Execute uma das seguintes tarefas:
Para
Choose
Mova o estilo
Mova
Mova o item
Mova
Excluir o item
Excluir
Desativar o item
Desativar
Reativar o item
Ativar
Copiar estilos de um gráfico para outro gráfico
Certifique-se de que a caixa de Legenda aparece no gráfico de origem.Se não estiver visível, abra o menu de atalho para uma área em branco de gráfico de origem.Escolha Mostrar Legenda.
Abra o menu de atalho para a caixa de Legenda .Escolha Copie a legenda.
Cole a legenda o elemento gráfico de destino.
Atribuir propriedades nós e a links
Você pode organizar nós e links para atribuir propriedades a eles.Por exemplo, você pode selecionar os nós que têm propriedades específicas de modo que você possa as agrupar, altere seu estilo, ou ocultar as.
Para atribuir uma propriedade para um nó
Abra o menu de atalho para o nó.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.
No elemento de <Node/> , especifique o nome da propriedade e seu valor.Por exemplo:
<Nodes> <Node Id="MyNode" MyPropertyName="PropertyValue" /> </Nodes>Adicione um elemento de <Property/> à seção de <Properties> para especificar atributos como seu nome e tipo de dados visíveis:
<Properties> <Property Id="MyPropertyName" Label="My Property" DataType="System.DataType"/> </Properties>
Para atribuir uma propriedade para um link
O elemento gráfico, mova o ponteiro do mouse sobre o link.Uma ferramenta de dica aparece e identifica o nó de origem e o nó de destino do link.(Teclado: Pressione Tabulação até o foco estiver no link.)
Abra o menu de atalho para o gráfico.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico.
Localize o elemento de <Link/> que contém os dois nomes de nó de origem e o nó de destino.
No elemento de <Node/> , especifique o nome da propriedade e seu valor.Por exemplo:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" /> </Links>Adicione um elemento de <Property/> à seção de <Properties> para especificar atributos como seu nome e tipo de dados visíveis:
<Properties> <Property Id="MyPropertyName" Label="My Property Name" DataType="System.DataType"/> </Properties>
Atribuir categorias a nós e a links
Você pode organizar nós atribuir categorias a eles.Por exemplo, você pode selecionar os nós que estão em determinadas categorias de modo que você possa as agrupar, altere seu estilo, ou ocultar as.Você pode realçar os links que possuem certas categorias.Para obter mais informações, consulte as seções a seguir:
Nós agrupar
Alterar o estilo de nós e os links
Ocultar ou exibir nós
Para atribuir uma categoria a um nó
- Para atribuir uma categoria predefinida, como Categoria 1, abra o menu de atalho para o nó.Escolha Categorizar e uma categoria pré-definida.
- ou -
Para criar e atribuir uma categoria personalizado:
- Escolha o nó que você deseja classificar.Pressione F4 para abrir a janela de Propriedades .Digite o nome da categoria na propriedade de Nova Categoria de nó.Pressione ENTER.
- ou -
Abra o menu de atalho para o nó.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.
No elemento de <Node/> , adicione um atributo de Category para especificar o nome da categoria.Por exemplo:
<Nodes> <Node Id="MyNode" Category="MyCategory" /> </Nodes>Adicione um elemento de <Category/> à seção de <Categories> para que você possa usar o atributo de Label para especificar o texto exibido para essa categoria:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
Para atribuir uma categoria a um link
O elemento gráfico, mova o ponteiro do mouse sobre o link para mostrar o tooltip e para identificar o nó de origem e o nó de destino do link.(Teclado: Pressione Tabulação até o foco estiver no link.)
Abra o menu de atalho para o gráfico.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico.
Localize o elemento de <Link/> que contém os dois nomes de nó de origem e o nó de destino.
No elemento de <Link/> , adicione um atributo de Category para especificar o nome da categoria.Por exemplo:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory" </Links>Adicione um elemento de <Category/> à seção de <Categories> para que você possa usar o atributo de Label para especificar o texto exibido para essa categoria:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
Você pode criar categorias hierárquicos para ajudar você a organizar e nós adicionar atributos as categorias filho usando a herança.
Para criar categorias hierárquicos
Adicione um elemento de <Category/> para a categoria pai e em seguida, adicione o atributo de BasedOn para o elemento de <Category/> de categoria filho.
Por exemplo:
<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>Nesse exemplo, o plano de fundo de MyFirstNode é verde porque o atributo de Category herda o atributo de Background de MyParentCategory.
Vincule itens nós ou para links
Você pode vincular itens, como documentos URL, ou a um nó ou um link editando o arquivo de .dgml de gráfico e adicionando um atributo Reference para o elemento de <Node/> para um nó ou elemento de <Link/> para um link.Você pode abrir e exibir o conteúdo do nó ou link.O atributo de Reference especifica o caminho do conteúdo.Isso pode ser um caminho relativo para o local do arquivo de .dgml ou um caminho absoluto.
| Cuidado |
|---|
Se você usar caminhos relativos, e o arquivo de .dgml é movido para um local diferente, então os caminhos não vai determinar.Quando você tenta abrir e exibir o conteúdo associado, um erro que indica que o conteúdo não pode ser exibido ocorrerá. |
Por exemplo, convém vincular os seguintes itens:
Para descrever as alterações a uma classe, você pode vincular o URL de um item de trabalho, do documento, ou outro arquivo de .dgml o nó para uma classe.
Você pode vincular um diagrama de camada a um nó de grupo que representa uma camada lógica na arquitetura de software.
Para mostrar mais informações sobre um componente que expõe uma interface, você pode vincular um diagrama componente ao nó para a interface.
Um nó vincular a um item ou um erro de trabalho Team Foundation Server, ou qualquer outra informação que estão relacionadas ao nó.
Para vincular um item para um nó
O elemento gráfico, abra o menu de atalho para o nó.Escolha Ir para, DGML.
O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.
Execute uma das tarefas na tabela a seguir:
Para vincular
Executar estas etapas
Um único item
No elemento de <Node/> ou de <Link/> , adicione um atributo de Reference para especificar o local do item.
Observação
Você pode ter apenas um atributo de Reference pelo elemento.
Por exemplo:
<Nodes> <Node Id="MyNode" Reference="MyDocument.txt" /> </Nodes> <Properties> <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" /> </Properties>Vários itens
No elemento de <Node/> ou de <Link/> , adicione um novo atributo para especificar o local de cada referência.
Na seção de <Properties> :
Adicione um elemento de <Property/> para cada novo tipo de referência.
Defina o atributo de Id o nome do novo atributo de referência.
Adicione o atributo de IsReference e defina-o como True para fazer a referência aparecer no menu de atalho de Ir para o item.
Use o atributo de Label para especificar o texto exibido no menu de atalho de Ir para o item.
Por exemplo:
<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>O elemento gráfico, o nome do nó aparece sublinhado.Quando você abre o menu de atalho para o nó ou o link, você verá um menu de atalho de Ir para que contém os itens associados para que você escolha.
Use o atributo de ReferenceTemplate para especificar uma cadeia de caracteres comuns, como um URL, que é usado por vários referências em vez de repetição essa cadeia de caracteres na referência.
O atributo de ReferenceTemplate especificar um espaço reservado para o valor de referência.No exemplo a seguir, o espaço reservado de {0} no atributo de ReferenceTemplate será substituído pelos valores de atributos MyFirstReference e de MySecondReference no elemento de <Node/> para gerar um caminho completo:
<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>Para exibir o item ou itens referenciados de gráfico, abra o menu de atalho para o nó ou do link.Escolha Ir para e o item.
Criar alias para caminhos de uso geral
Substituindo caminhos de usados com alias ajuda a reduzir o tamanho do arquivo de .dgml e de tempo necessário para carregar ou salve o arquivo.Para criar um alias, adicione uma seção de <Paths></Paths> no final do arquivo de .dgml.Nesta seção, adicione um elemento de <Path/> para definir um alias para o caminho:
<Paths>
<Path Id="MyPathAlias" Value="C:\...\..." />
</Paths>
Para referenciar alias de um elemento no arquivo de .dgml, incluindo o valor de Id do elemento de <Path/> com um cifrão ($) e parênteses (()):
<Nodes>
<Node Id="MyNode" Reference="$(MyPathAlias)MyDocument.txt" />
</Nodes>
<Properties>
<Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" />
</Properties>
Linguagem de marcação direcionada compreensão (DGML) chart
DGML usa XML simples para descrever gráficos direcionados cíclicos e acíclicos.Um gráfico direcionado é um conjunto de nós que estão conectados por links, ou de bordas.Os nós e links podem ser usados representam estruturas de rede, como elementos em um projeto de software.Use DGML para visualizar informações, para executar a análise de complexidade, ou procurar e editar apenas direcionaram gráficos.
Os nós e links são chamados elementos de gráfico, ou apenas os elementos.A tabela a seguir descreve os tipos de elementos que são usados em DGML:
| Observação |
|---|
Quando você edita um arquivo de .dgml, ajuda do IntelliSense você identifica os atributos que estão disponíveis para cada elemento e seus valores.Para especificar a cor em um atributo, use cores para nomes comuns, como “blue”, ou valores hexadecimais ARGB, como “#ffa0b1c3”.DGML usa um subconjunto pequeno de formatos de definição de cor do Windows Presentation Foundation (WPF).Para obter mais informações, Classe de coresconsulte. |
Elemento |
Formato de exemplo |
|---|---|
<DirectedGraph></DirectedGraph> Esse elemento é o elemento raiz de documento direcionado de gráfico (.dgml).Todos os outros elementos de DGML aparecem no escopo deste elemento. A lista a seguir descreve os atributos opcionais que você pode incluir:
|
|
<Nodes></Nodes> Esse elemento opcional contém uma lista de elementos de <Node/> , que definem nós no gráfico.Para obter mais informações, consulte o elemento de <Node/> . Observação
Quando você referencia um nó indefinido em um elemento de <Link/> , o gráfico a seguir cria um elemento de <Node/> automaticamente.
|
|
<Node/> Este elemento define um único nó.Aparece na lista de elemento de <Nodes><Nodes/> . Esse elemento deve incluir os seguintes atributos:
A lista a seguir descreve alguns dos atributos opcionais que você pode incluir:
|
|
<Links></Links> Esse elemento contém a lista de elementos de <Link> , que definem os links entre nós.Para obter mais informações, consulte o elemento de <Link/> . |
|
<Link/> Este elemento define um único link que conecta um nó de origem para um nó de destino.Aparece na lista de elemento de <Links></Links> . Observação
Se este elemento referencia um nó indefinido, o documento de gráfico cria automaticamente um nó que possui os atributos especificados, se houver.
Esse elemento deve incluir os seguintes atributos:
A lista a seguir descreve alguns dos atributos opcionais que você pode incluir:
|
|
<Categories></Categories> Esse elemento contém a lista de elementos de <Category/> .Para obter mais informações, consulte o elemento de <Category/> . |
|
<Category/> Este elemento define um atributo de Category , que é usado para identificar os elementos que compartilham esse atributo.Um atributo de Category pode ser usado para organizar elementos de gráfico, para prevê-los atributos compartilhados com herança, ou para definir metadados adicionais. Esse elemento deve incluir os seguintes atributos:
A lista a seguir descreve alguns dos atributos opcionais que você pode incluir:
As categorias também oferecem algum comportamento básico de modelo que controla a aparência dos nós e a links quando são exibidas em um gráfico.Consulte Aplicar estilos personalizados para nós e a links. |
|
<Properties></Properties> Esse elemento contém a lista de elementos de <Property/> .Para obter mais informações, consulte o elemento de <Property/> . |
|
<Property/> Este elemento define um atributo de Property que você pode usar para atribuir um valor para qualquer elemento ou atributo da DGML, incluindo categorias e outras propriedades. Esse elemento deve incluir os seguintes atributos:
Se você desejar que a propriedade para aparecer na janela de Propriedades , use a propriedade de Label para especificar o nome para exibição da propriedade. Consulte Atribuir propriedades nós e a links. |
|
Consulte também
Conceitos
Visualizar dependências de código em gráficos de dependência