Como: Editar e personalizar documentos do gráfico
Em Visual Studio Ultimate, você pode focalizar relações de chave e áreas de um gráfico direcionado Editar editando os nós e links. Isso é especialmente útil quando o gráfico mostra grandes quantidades de informações. Por exemplo, você pode identificar os principais componentes em um sistema de software existente e as relações entre eles. Você pode compartilhar e discutir as áreas de foco com membros da equipe. Para obter informações sobre como gerar gráficos a partir do código, consulte Como: Gere gráficos de dependência para.NET de código.
Para realçar as áreas de interesse, você pode selecionar nós pelo filtro, aplicar estilos predefinidos para nós e os links e organizar nós em grupos. Você pode personalizar ainda mais o gráfico, editando o arquivo de linguagem de marcação de gráfico direcionado (DGML) do gráfico. Por exemplo, você pode editar os elementos DGML no arquivo para especificar os estilos personalizados, atribuir propriedades e categorias para nós e os links ou vincular a nós para itens, como, por exemplo, documentos, URLs e outros arquivos de .dgml. Para obter mais informações sobre os elementos DGML, consulte Compreensão direcionado gráfico Markup Language (DGML).
Observação |
---|
Visual StudioLimpa quaisquer atributos e elementos DGML não utilizados por excluí-los quando você salvar o arquivo .dgml. Ele também cria elementos nós automaticamente quando você adiciona novos vínculos manualmente. Quando você salva o arquivo .dgml, todos os atributos que você adicionou um elemento podem reorganizar os próprios em ordem alfabética. |
Você pode editar um gráfico das seguintes maneiras:
Selecione nós
Ocultar ou Mostrar nós
Mostrar ou ocultar os links
Alterar o estilo de gráfico
Alterar o estilo de nós e links
Copiar estilos de um gráfico para outro gráfico
Organizar nós em grupos
Atribuir propriedades a nós e links
Atribuir categorias a nós e links
Vincular itens a nós
Criar aliases de caminhos usados comumente
Selecione nós
Para |
Execute essas etapas. |
---|---|
Selecione a categorias específicas de nós |
Para criar e atribuir uma categoria personalizada, consulte Atribuir categorias a nós e Links. |
Selecione nós com propriedades específicas ou valores de propriedade |
|
Adicionar nós relacionados aos selecionados |
Os nós selecionados com o botão direito, aponte para seleçãoe escolha uma das seguintes opções:
|
Selecione todos os nós não selecionados |
Os nós selecionados com o botão direito, aponte para seleçãoe em seguida, clique em Inverter. |
Ocultar ou Mostrar nós
Ocultando a nós no gráfico remove-los que aparecem no gráfico e participando de qualquer algoritmos de layout.
Para |
Execute essas etapas. |
---|---|
Ocultar nós selecionados |
|
Ocultar nós com determinadas propriedades ou categorias |
|
Ocultar nós não selecionados |
|
Mostrar todos os nós ocultos |
Clique com o botão direito do gráfico, aponte para seleçãoe em seguida, clique em Reexibir todos os. |
Para ocultar nós editando o arquivo .dgml
Clique com o botão direito na superfície do gráfico e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico.
No <Node/> elemento, adicione o seguinte atributo para ocultar o nó:
Visibility="Hidden"
Por exemplo:
<Nodes> <Node Id="MyNode" Visibility="Hidden"/> </Nodes>
Mostrar ou ocultar Links
Você pode controlar a quantidade de detalhes em um gráfico, especificando os tipos de links que você deseja ver. O gráfico mostra dois tipos de links: links diretos entre nós e os links entre grupos, que estão ocultos por padrão. Os links entre grupos são os links individuais que conectam nós em grupos diferentes.
Quando grupos estão recolhidos, o gráfico agrega todos os links entre grupos em links de único entre os grupos. Quando grupos são expandidos, você pode selecionar nós dentro do grupo e os novos vínculos de grupo entre aparecem e mostram as dependências reais dentro desse grupo.
Para mostrar ou ocultar os links
Se a barra de ferramentas do gráfico não estiver visível, no Exibir , aponte para barras de ferramentase em seguida, clique em Gráfico direcionado.
Selecione uma tarefa da tabela a seguir:
Para
Clique em
Mostrar todos os links de entre grupos em todas as ocasiões
Mostrar todos os Links de entre grupos
Mostrar somente os links de entre grupos de links que estão conectados para nós selecionados
Mostrar os Links entre grupos em nós selecionados
Ocultar todos os links de entre grupos em todas as ocasiões
Ocultar todos os Links de entre grupos
Ocultar todos os links (ou mostrar todos os links)
Ocultar todos os Links
Para mostrar todos os links, clique em Ocultar todos os Links novamente para desativar esse modo.
Alterar o estilo de gráfico
Você pode alterar a cor de plano de fundo e a cor da borda do gráfico, editando o arquivo de .dgml do gráfico. Para alterar o estilo de nós e links, consulte alterar o estilo de nós e os Links.
Para alterar o estilo do gráfico
Clique com o botão direito na superfície do gráfico e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico.
No <DirectedGraph> elemento, adicionar qualquer um dos seguintes atributos para alterar o seu estilo:
Para alterar o
Adicione o seguinte atributo
Cor de 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 Links
Você pode alterar os ícones em nós e as cores de nós e links. Você pode usar os ícones e cores predefinidas ou você pode especificar os itens personalizados, editando o arquivo de .dgml do gráfico. Para obter mais informações, consulte Aplicar estilos de personalizado para nós e os Links.
Por exemplo, você pode escolher uma cor para destacar nós e os links que têm uma certa categoria ou propriedade. Isso permite identificar e se concentrar em áreas específicas do gráfico.
Para aplicar uma cor predefinida ou um ícone para nós com uma certa categoria ou propriedade
Se o legenda caixa não estiver visível, clique com o botão direito do gráfico e, em seguida, clique em Mostrar legenda.
No legenda caixa, se a propriedade ou a categoria de nó é exibido na lista.
Se a lista não inclui a categoria ou propriedade, clique em Add, aponte para Categoria de nó ou Propriedade do nóe selecione a categoria ou propriedade.
Observação Para criar e atribuir uma categoria para um nó, consulte Atribuir categorias a nós e Links. Para criar e atribuir uma propriedade para um nó, consulte Atribuir propriedades a nós e Links.
No legenda caixa, clique na lista suspensa próxima à categoria ou propriedade.
Use a tabela a seguir para selecionar o estilo que você deseja alterar:
Para alterar o
Select
Cor de plano de fundo
Segundo plano
Cor de contorno
Traçado
Cor do texto
Primeiro plano
Ícone
Ícones
Na caixa de diálogo Seletor, escolha um destes procedimentos:
Para aplicar um
Siga estas etapas.
Conjunto de cores (ou ícones)
Clique o Selecione cor (ícone) set drop-down lista e clique em um conjunto de cores (ou ícones).
Para reverter para o padrão cor (ou ícone), no Selecione cor (ícone) Definir na lista suspensa, clique em Nenhum.
Cor específica (ou ícone)
Clique na categoria ou a propriedade valor na lista suspensa e, em seguida, selecione uma cor (ou ícone).
Quando você tiver terminado, clique em OK.
Observação Você pode reorganizar, excluir ou inativar temporariamente os estilos no legenda caixa. Para obter mais informações, consulte modificar a caixa de legenda.
Para aplicar uma cor predefinida para links com uma certa categoria ou propriedade
Se o legenda caixa não estiver visível, clique com o botão direito do gráfico e, em seguida, clique em Mostrar legenda.
No legenda caixa, se a propriedade ou a categoria é exibido na lista.
Se a lista não inclui a categoria ou propriedade, clique em Add, aponte para Categoria de Link ou Propriedade Linke selecione a categoria ou propriedade.
Observação Para criar e atribuir uma categoria a um link, consulte Atribuir categorias a nós e Links. Para criar e atribuir uma propriedade a um link, consulte Atribuir propriedades a nós e Links.
No legenda caixa, clique na lista suspensa próxima à categoria ou propriedade.
Use a tabela a seguir para selecionar o estilo que você deseja alterar:
Para alterar o
Select
Cor da ponta de seta
Segundo plano
Cor de contorno
Traçado
No Seletor de cores definida caixa, escolha uma das seguintes opções:
Para aplicar um
Siga estas etapas.
Conjunto de cores
Clique o Selecione cor set drop-down lista e clique em um conjunto de cores.
Para reverter para a cor do padrão na Selecione o conjunto de cores na lista suspensa, clique em Nenhum.
Cor específica
Clique no tipo ou a propriedade valor na lista suspensa para selecionar uma cor.
Quando você tiver terminado, clique em OK.
Observação Você pode reorganizar, excluir ou inativar temporariamente os estilos no legenda caixa. Para obter mais informações, consulte modificar a caixa de legenda.
Aplicar estilos personalizados a nós e Links
Você pode aplicar estilos personalizados para os seguintes itens:
Links e nós únicos
Grupos de nós e links
Grupos de nós e links com base em determinadas condições.
Para aplicar um estilo personalizado para um único nó
Clique com o botão direito no nó cujo estilo você deseja personalizar e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico e destaca a <Node/> elemento para o nó.
No <Node/> elemento, adicionar qualquer um dos seguintes atributos para personalizar o seu estilo:
Para alterar o
Adicione o seguinte atributo
Cor de plano de fundo
Background="ColorNameOrHexadecimalValue"
Estrutura de tópicos
Stroke="ColorNameOrHexadecimalValue"
Espessura do contorno
StrokeThickness="StrokeValue"
Cor do texto
Foreground="ColorNameOrHexadecimalValue"
Ícone
Icon="IconFilePathLocation"
Tamanho do texto
FontSize="FontSizeValue"
Tipo de texto
FontFamily="FontFamilyName"
Peso do 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
Shape
Por exemplo:
<Nodes> <Node Id="MyNode" Background="Green" Stroke="#FF000000" Foreground="White" Icon="...\Graph Icons\MyNodeIcon.jpg"/> </Nodes>
Para aplicar um estilo personalizado para um único link
No gráfico, mova o ponteiro do mouse sobre o link para mostrar a dica de ferramenta e identificar o nó de origem e o nó de destino do link.
Clique com o botão direito do gráfico e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico.
Encontrar o <Link/> elemento que contém tanto os nomes da fonte nó e o destino nó.
No <Link/> elemento, adicionar qualquer um dos seguintes atributos para personalizar o seu estilo:
Para alterar o
Adicione o seguinte atributo
Cor da ponta de seta
Background="ColorNameOrHexadecimalValue"
Cor de contorno
Stroke="ColorNameOrHexadecimalValue"
Espessura do contorno
StrokeThickness="StrokeValue"
Estilo do contorno
StrokeDashArray="StrokeArrayValues"
Por exemplo:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Background="Green" Stroke="#FF000000" /> </Links>
Para aplicar estilos personalizados a um grupo de nós ou links
Atribua quaisquer categorias ou propriedades que você deseja para os nós ou links.
Para obter mais informações, consulte Atribuir categorias a nós e Links e Atribuir propriedades a nós e Links.
Clique com o botão direito na superfície do gráfico e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico.
Se um <Styles></Styles> elemento não existe, adicione um sob a <DirectedGraph></DirectedGraph> elemento após o <Links></Links> elemento.
No <Styles></Styles> elemento, na <Style/> elemento e especificar os seguintes atributos:
TargetType="Node | Link | Graph"
GroupLabel="NameInLegendBox"
ValueLabel="NameInStylePickerBox"
Para aplicar um estilo personalizado a todos os tipos de destino, não use uma condição.
Para aplicar um estilo de condicional a grupos de nós ou links
No <Style/> elemento, adicione um <Condition/> elemento que contém um Expression atributo 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')"/>
Essa expressão utiliza a seguinte sintaxe de forma de Backus-Naur (BNF):
<Expression> :: = <BinaryExpression> | <UnaryExpression> | "("<Expression> ")" | <MemberBindings> | <Literal> | <Number>
<BinaryExpression> :: = <Expression> <Operator> <Expression>
<UnaryExpression> ::= "!" <Expression> | "+" <Expression> | "-" <Expression>
<Operator> ::= "<" | "< =" | "=" | "> =" | ">" | "!=" | "ou" | "e" | "+" | "*" | "/" | "-"
<MemberBindings> :: = <MemberBindings> | <MemberBinding> "." <MemberBinding>
<MemberBinding> :: = <MethodCall> | <PropertyGet>
<MethodCall> :: = <Identifier> "(" <MethodArgs> ")"
<PropertyGet> :: = Identificador
<MethodArgs> :: = <Expression> | <Expression> "," <MethodArgs> | <empty>
<Identifier> ::= [^. ]*
<Literal> :: = único ou aspas duplas literal de seqüência
<Number> :: = seqüência de dígitos com vírgula decimal opcional
Você pode especificar vários <Condition/> elementos, que deverão ser verdadeiras para aplicar o estilo.
Na linha seguinte após o <Condition/> elemento, adicione um ou vários <Setter/> elementos para especificar um Property um fixo e atributo Value atributo ou uma computada Expression atributo para aplicar ao gráfico, nós ou links que atendem a condição.
Por exemplo:
<Setter Property="BackGround" Value="Green"/>
Como um simple exemplo completo, a condição a seguir especifica que um nó aparece verde ou vermelho com base no seu Passed categoria é definida como True ou 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 algumas condições de exemplo que você pode usar:
Para |
Exemplo DGML |
---|---|
Defina o tamanho da fonte como uma função do número de linhas de código, que também altera o tamanho do nó. Este exemplo usa uma única expressão condicional para definir várias propriedades, FontSize e FontFamily. |
|
Definir a cor de plano de fundo de um nó com base na Coverage propriedade. Os estilos são avaliados na ordem em que aparecem, semelhantes a if-else instruções. Nesse exemplo:
|
|
Definir o Shape propriedade para None para que o ícone substitui a forma. Use o Icon propriedade para especificar a localização do ícone. |
|
Modificar a caixa de legenda
Você pode reorganizar, excluir ou inativar temporariamente os estilos no legenda caixa:
Um estilo com o botão direito do legenda caixa.
Execute uma das seguintes tarefas:
Para
Clique em
O estilo de mover para cima
Mover para cima
Mover o item para baixo
Mover para baixo
Excluir o item
Excluir
Desativar o item.
Desabilitar
Reativar o item.
Habilitar
Copiar estilos de um gráfico para outro gráfico
- Clique com o botão direito do gráfico de origem, clique em Copy legendae cole o estilo para o gráfico de destino.
Organizar nós em grupos
Para |
Execute essas etapas. |
---|---|
Mostrar nós com relações de confinamento, como grupos ou links |
Para mostrar os links como grupos, selecione os nós de contêiner, clique com o botão direito na sua seleção, aponte para grupoe em seguida, clique em Mostrar como o grupo. Para mostrar grupos como links, selecione os nós de contêiner, clique com o botão direito na sua seleção, aponte para grupoe em seguida, clique em Mostrar como Link. Para mostrar todos os grupos, como links, clique com o botão direito do gráfico, aponte para grupoe em seguida, clique em Mostrar todas as como Links. Para mostrar todos os links como grupos, clique com o botão direito do gráfico, aponte para grupoe em seguida, clique em Mostrar todas as como grupos. |
Adicionar um novo grupo em torno de nós selecionados |
|
Adicionar um novo grupo em torno de nós que têm propriedades ou categorias específicas |
|
Nós de grupo de acordo com seus contêineres |
|
Nós de grupo de acordo com seus valores de propriedade |
|
Remover grupos |
Selecione o grupo ou grupos que você deseja remover, clique com o botão direito na sua seleção, aponte para grupoe em seguida, clique em Remover grupo. |
Remover nós do seu grupo pai até seu avô ou fora de um grupo, se eles tiverem nenhum grupo avô |
Selecione os nós que você deseja mover, clique com o botão direito na sua seleção, aponte para grupoe em seguida, clique em Remover do pai. |
Você também pode organizar nós em grupos, editando o arquivo de .dgml do gráfico.
Para usar um nó existente como um grupo ou adicionar um novo grupo.
Para usar um nó existente como um grupo, clique com o botão direito no nó que você deseja usar como um nó de grupo e clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico e destaca a <Node/> elemento para o nó.
- ou -
Para adicionar um novo grupo, clique com o botão direito do gráfico e, em seguida, clique em Exibir DGML.
No <Nodes> seção, adicionar um novo <Node/> elemento.
No <Node/> elemento, adicione um Group atributo para especificar se o grupo aparece expandidos ou recolhidos. Por exemplo:
<Nodes> <Node Id="MyFirstGroup" Group="Expanded" /> <Node Id="MySecondGroup" Group="Collapsed" /> </Nodes>
No <Links> seção, certifique-se de que uma <Link/> elemento que possui os seguintes atributos de existir para cada relação entre um nó de grupo e seus nós filhos:
A Source atributo que especifica o nó de grupo
A Target atributo que especifica o nó filho
A Category atributo que especifica um Contains o relacionamento entre o nó de grupo e o seu 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 Category de atributo, consulte Atribuir categorias a nós e Links.
Atribuir propriedades a nós e Links
Você pode organizar nós e os links, atribuindo propriedades. Por exemplo, você pode selecionar os nós que têm propriedades específicas para que você pode agrupá-los, alterar seu estilo ou ocultá-los.
Para atribuir uma propriedade para um nó
Clique com o botão direito no nó e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico e destaca a <Node/> elemento para o nó.
No <Node/> elemento, especifique o nome da propriedade e valor. Por exemplo:
<Nodes> <Node Id="MyNode" MyPropertyName="PropertyValue" /> </Nodes>
Adicionar um <Property/> elemento para o <Properties> seção para especificar atributos como, por exemplo, seu tipo de nome e os dados visível:
<Properties> <Property Id="MyPropertyName" Label="My Property" DataType="System.DataType"/> </Properties>
Para atribuir uma propriedade a um link
No gráfico, mova o ponteiro do mouse sobre o link para mostrar a dica de ferramenta e identificar o nó de origem e o nó de destino do link.
Clique com o botão direito do gráfico e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico.
Encontrar o <Link/> elemento que contém tanto os nomes da fonte nó e o destino nó.
No <Node/> elemento, especifique o nome da propriedade e valor. Por exemplo:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" /> </Links>
Adicionar um <Property/> elemento para o <Properties> seção para especificar atributos como, por exemplo, seu tipo de nome e os dados visível:
<Properties> <Property Id="MyPropertyName" Label="My Property Name" DataType="System.DataType"/> </Properties>
Atribuir categorias a nós e Links
Você pode organizar nós, atribuindo categorias. Por exemplo, você pode selecionar nós que estejam em certas categorias para que você pode agrupá-los, alterar seu estilo ou ocultá-los. Você pode realçar links com determinadas categorias. Para obter mais informações, consulte as seções a seguir:
Organizar nós em grupos
Alterar o estilo de nós e links
Ocultar ou Mostrar nós
Para atribuir uma categoria para um nó
- Para atribuir uma categoria predefinida, como categoria 1, o botão direito do mouse no nó, aponte para categorizare clique em uma categoria predefinida.
- ou -
Para criar e atribuir uma categoria personalizada:
- Clique no nó que você deseja categorizar, pressione F4 para abrir o Propriedades janela, digite o nome da categoria no nó de Nova categoria propriedade e pressione ENTER.
- ou -
Clique com o botão direito no nó e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico e destaca a <Node/> elemento para o nó.
No <Node/> elemento, adicione um Category atributo para especificar o nome da categoria. Por exemplo:
<Nodes> <Node Id="MyNode" Category="MyCategory" /> </Nodes>
Adicionar um <Category/> elemento para o <Categories> seção para que você possa usar o Label atributo para especificar o texto de exibição dessa categoria:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
Para atribuir uma categoria a um link
No gráfico, mova o ponteiro do mouse sobre o link para mostrar a dica de ferramenta e identificar o nó de origem e o nó de destino do link.
Clique com o botão direito do gráfico e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico.
Encontrar o <Link/> elemento que contém tanto os nomes da fonte nó e o destino nó.
No <Link/> elemento, adicione um Category atributo para especificar o nome da categoria. Por exemplo:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory" </Links>
Adicionar um <Category/> elemento para o <Categories> seção para que você possa usar o Label atributo para especificar o texto de exibição dessa categoria:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
Você pode criar categorias hierárquicas para ajudá-lo a organizar a nós e adicionar os atributos para as categorias filho, usando a herança.
Para criar categorias hierárquicas
Adicionar um <Category/> elemento para a categoria pai e, em seguida, adicione a BasedOn atributo para a categoria de filho <Category/> elemento.
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>
Neste exemplo, o plano de fundo de MyFirstNode é verde porque sua Category atributo herda o Background atributo do MyParentCategory.
Vincular itens a nós
Você pode vincular itens, como, por exemplo, documentos ou URLs, para um nó editando o arquivo de .dgml do gráfico e adicionando um Reference de atributo para o <Node/> elemento do nó. O Reference atributo especifica o caminho do conteúdo. Isso pode ser um caminho relativo para o local do arquivo .dgml ou um caminho absoluto. Você pode abrir e exibir o conteúdo do nó no gráfico.
Observação |
---|
O item referenciado ou itens devem existir para poder exibi-los |
Por exemplo, convém vincular os seguintes itens:
Para descrever as alterações a uma classe, você pode vincular a URL de um item de trabalho, documento ou outro arquivo de .dgml ao nó em uma classe.
Você pode vincular a um diagrama de camada para um nó de grupo que representa uma camada em que a arquitetura lógica do software.
Para obter mais informações sobre um componente que expõe uma interface de mostrar, você pode vincular a um diagrama de componente para o nó para aquela interface.
Vincular a um nó para um Team Foundation Server trabalhar item ou o bug ou outras informações que estão relacionadas ao nó.
Para vincular um item a um nó
No gráfico, clique com o botão direito no nó e, em seguida, clique em Exibir DGML.
Visual StudioAbre o arquivo de .dgml do gráfico e destaca a <Node/> elemento para o nó.
Execute uma das tarefas na tabela a seguir:
Para vincular
Siga estas etapas.
Um único item
No <Node/> elemento, adicione um Reference atributo para especificar o local do item.
ObservaçãoVocê só pode ter um Reference atributo por <Node/> 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 <Node/> elemento, adicionar um novo atributo para especificar o local de cada referência.
No <Properties> seção:
Adicionar um <Property/> elemento para cada novo tipo de referência.
Definir o Id atributo para o nome do novo atributo de referência.
Adicionar o IsReference de atributo e defina-o para True para fazer a referência que aparecem no nó do Goto o menu de atalho.
Use o Label atributo para especificar o texto de exibição para o nó Goto o menu de atalho.
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>
No gráfico, o nome do nó aparece sublinhado.
Use o ReferenceTemplate atributo para especificar uma seqüência de caracteres comuns, como uma URL, que é usada por várias referências em vez de repetir essa cadeia de caracteres na referência.
O ReferenceTemplate atributo especifica um espaço reservado para o valor de referência. No exemplo a seguir, o {0} espaço reservado na ReferenceTemplate atributo será substituído pelos valores da MyFirstReference e MySecondReference atributos na <Node/> elemento para produzir 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>
Execute uma das seguintes tarefas para exibir o item referenciado:
Para exibir
Execute a seguinte etapa
Um único item
Clique duas vezes no nó.
- ou -
Clique com o botão direito no nó, aponte para Gotoe em seguida, clique no item.
Vários itens
Clique com o botão direito no nó, aponte para Gotoe clique em um item.
Criar Aliases para caminhos normalmente usado
Substituindo a aliases de caminhos usados comumente o ajuda a reduzir o tamanho do arquivo .dgml e o tempo necessário para carregar ou salvar o arquivo. Para criar um alias, adicione um <Paths></Paths> seção no final do arquivo .dgml. Nesta seção, adicione um <Path/> elemento para definir um alias para o caminho:
<Paths>
<Path Id="MyPathAlias" Value="C:\...\..." />
</Paths>
Para fazer referência o alias de um elemento no arquivo .dgml, coloque o Id valor de <Path/> elemento com um sinal de 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>
Noções básicas sobre direcionado a linguagem de marcação de gráfico (DGML)
DGML usa o XML simple para descrever cíclicos e acíclica gráficos direcionados. Um gráfico direcionado é um conjunto de nós que estão conectados por links ou bordas. Nós e os links podem ser usados representar estruturas de rede, como, por exemplo, elementos em um projeto de software. Use DGML para visualizar informações, realizar análises de complexidade, ou apenas procurar e editar gráficos direcionados.
Nós e os links são chamados de elementos de gráfico ou apenas 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, IntelliSense ajuda você a identificar os atributos que estão disponíveis para cada elemento e seus valores. Para especificar a cor em um atributo, use nomes de cores comuns, como, por exemplo, "Blue", ou valores de hexadecimais ARGB, como, por exemplo, "# ffa0b1c3". DGML usa um pequeno subconjunto dos formatos de definição de cor Windows Presentation Foundation (WPF). Para obter mais informações, consulte A classe de cores. |
Elemento |
Exemplo de formato |
---|---|
<DirectedGraph></DirectedGraph> Este elemento é o elemento raiz do documento de gráfico direcionado (.dgml). Todos os outros elementos DGML aparecem dentro do escopo deste elemento. A lista a seguir descreve os atributos opcionais que você pode incluir:
|
|
<Nodes></Nodes> Este elemento opcional contém uma lista de <Node/> elementos, que definem nós no gráfico. Para obter mais informações, consulte o <Node/> elemento.
Observação
Quando você faz referência a um nó indefinido em um <Link/> elemento, o graph cria um <Node/> elemento automaticamente.
|
|
<Node/> Este elemento define um único nó. Ele aparece dentro de <Nodes><Nodes/> lista de elemento. Este 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 <Link> elementos, que definem os vínculos entre nós. Para obter mais informações, consulte o <Link/> elemento. |
|
<Link/> Este elemento define um único link que conecta a um nó de origem para um nó de destino. Ele aparece dentro de <Links></Links> lista de elemento.
Observação
Se esse elemento fizer referência a um nó indefinido, o documento gráfico cria automaticamente um nó que possui os atributos especificados, se houver.
Este 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 <Category/> elementos. Para obter mais informações, consulte o <Category/> elemento. |
|
<Category/> Este elemento define um Category atributo, que é usado para identificar os elementos que compartilham este atributo. A Category atributo pode ser usado para organizar os elementos gráficos, fornecer para os atributos compartilhados através de herança ou definir metadados adicionais. Este 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 do modelo básico que controla a aparência de nós e os links quando elas são exibidas em um gráfico. Para obter mais informações, consulte Aplicar estilos de personalizado para nós e os Links. |
|
<Properties></Properties> Esse elemento contém a lista de <Property/> elementos. Para obter mais informações, consulte o <Property/> elemento. |
|
<Property/> Este elemento define um Property atributo que você pode usar para atribuir um valor para qualquer elemento DGML ou atributo, incluindo as categorias e outras propriedades. Este elemento deve incluir os seguintes atributos:
Se você desejar que a propriedade apareça na Propriedades janela, use o Label propriedade para especificar o nome de exibição. da propriedade Para obter mais informações, consulte Atribuir propriedades a nós e Links. |
|
Consulte também
Conceitos
Como: Gere gráficos de dependência para.NET de código