Editar y personalizar gráficos de dependencias
Puede editar gráficos de dependencias sin afectar al código subyacente.Esto es útil cuando desea centrarse en los elementos clave o para comunicar ideas sobre el código.Por ejemplo, para resaltar áreas interesantes, puede seleccionar nodos y filtrarlos, cambiar el estilo de los nodos y vínculos, ocultar o los nodos de cancelación, y organizar los nodos mediante propiedades, categorías, o grupos.
Puede personalizar un gráfico aún más editando el archivo Directed Graph markup language de gráfico (.dgml).Por ejemplo, puede modificar elementos para especificar estilos personalizados, asignar propiedades y categorías a nodos y vínculos, o vincular nodos a elementos, como documentos, direcciones URL, u otros dibujos.
[!NOTA]
Visual Studio limpia los atributos y elementos de DGML que no cuando se guarda el archivo .dgml.También crea automáticamente los elementos de nodo cuando se agregan los nuevos vínculos manualmente. Cuando se guarda el archivo .dgml, cualquier atributo agregado a un elemento puede reorganizar en orden alfabético.Para obtener más información sobre los elementos de DGML, vea Introducción a Directed Graph Markup Language (DGML).
Requisitos
Visual Studio Ultimate, Visual Studio Premium o Visual Studio Profesional.
Para crear gráficos de dependencias, debe tener Visual Studio Ultimate.Vea Visualizar dependencias de código en gráficos de dependencias.
En este tema
Nodos o vínculos seleccionar
Cambie el nombre de los nodos o vínculos
Ocultar o mostrar nodos y vínculos
Agregue los nodos y vínculos
Agregue comentarios en el gráfico
Elimine los nodos
Agrupe los nodos
Combinar gráficos
Cambiar el estilo del gráfico
Cambie el nodo o vincule el estilo
Copiar estilos de un gráfico a otro
Asignar propiedades a nodos y vínculos
Asignar categorías a nodos y vínculos
Vincular elementos a nodos o vínculos
Crear alias para rutas de acceso usadas con frecuencia
Nodos o vínculos seleccionar
Para |
Siga estos pasos |
---|---|
Seleccionar todos los nodos no seleccionados |
Abra el menú contextual para los nodos seleccionados.Elija Seleccionar, Invertir selección. |
Seleccione los nodos adicionales que se vinculan con los seleccionados. |
Abra el menú contextual para los nodos seleccionados.Elija Seleccionar y uno de los siguientes:
|
Cambie el nombre de los nodos o vínculos
Seleccione el nodo o vínculo.Presione F2.Cuando aparezca el cuadro de edición, cambie el nombre del nodo o vínculo.
Si la etiqueta está visible, seleccione la etiqueta.
Ocultar o mostrar nodos y vínculos
Al ocultar los nodos se evita que participen en algoritmos de diseño.De forma predeterminada, los vínculos entre grupos se ocultan.Los vínculos entre grupos son vínculos individuales que conectan nodos entre diferentes grupos.Cuando los grupos se contraen, el gráfico agrega todos los vínculos entre grupos a los vínculos individuales que hay entre los grupos.Cuando se expanden los grupos y se seleccionan los nodos que hay dentro de un grupo, los vínculos entre grupos aparecen y muestran las dependencias que existen dentro de ese grupo.
Precaución |
---|
Antes de compartir un gráfico creado en Visual Studio Ultimate con los que usen Visual Studio Premium o Visual Studio Professional, asegúrese de revelar cualquier nodo o vínculo entre grupos que desee que otros vean.Si no, los usuarios no podrán mostrar esos elementos. |
Ocultar o mostrar nodos
Para |
Siga estos pasos |
---|---|
Ocultar los nodos seleccionados |
|
Ocultar nodos no seleccionados |
|
Mostrar todos los nodos ocultos |
|
Oculte nodos editando el archivo .dgml |
|
Para mostrar u ocultar vínculos
Para |
En la barra de herramientas del gráfico, abra la lista Cambiar el modo en que se presentan los vínculos en el gráfico o abra el menú contextual del gráfico. Elija: |
---|---|
Mostrar todos los vínculos entre grupos en todo momento |
Mostrar todos los vínculos entre grupos Esto oculta vínculos agregados entre grupos. |
Mostrar los vínculos entre grupos de los nodos seleccionados |
Mostrar los vínculos entre grupos de los nodos seleccionados |
Ocultar todos los vínculos entre grupos en todo momento |
Vínculos de Cruce- grupo hide |
Ocultar todos los vínculos (o mostrar todos los vínculos) |
Ocultar todos los vínculos Para mostrar todos los vínculos, haga clic de nuevo en Ocultar todos los vínculos para desactivar este modo. |
Agregue los nodos y vínculos
Para agregar un nuevo nodo no definido |
Siga estos pasos |
---|---|
En la ubicación actual del puntero |
Seleccione un lugar del gráfico donde colocar el nuevo nodo.Presione Insertar. |
Ese vínculos al nodo seleccionado |
|
Ese vínculos a un nodo existente con el foco actual |
Presione Tab hasta el nodo al que desea vincular tiene el foco.Presione alt+Mayús.+Insertar. |
Para agregar nodos para |
Siga estos pasos |
---|---|
Elementos de la solución |
|
Elementos relacionados con los nodos del gráfico |
Abra el menú contextual para el nodo.Elija Mostrar y la clase de relación que le interese. Para un ensamblado, elija:
Para una clase, elija:
Para un método, elija:
Para un campo, elija:
|
Ensamblados compilados de .NET (.dll o .exe) o binarios |
Utilice explorador de arquitectura para buscar y para arrastrar elementos y relaciones al gráfico. |
Para agregar un vínculo entre los nodos existentes
Seleccione el nodo de origen.
Una barra de herramientas empieza a aparecer encima del nodo.
En la barra de herramientas, elija Establezca las nuevas relaciones de este nodo al que nunca nodo que hace clic en después a continuación.Seleccione el nodo de destino.
Un vínculo aparece entre los dos nodos.
Agregue comentarios en el gráfico
Seleccione el nodo donde desea agregar un comentario vinculado.
Una barra de herramientas empieza a aparecer encima del nodo.
En la barra de herramientas, elija Cree un nuevo nodo de comentario con un nuevo vínculo al nodo seleccionado.
Escriba comentarios.Para escribir en una nueva línea, presione MAYÚS.+Entrar.
Elimine los nodos
Puede eliminar nodos de un gráfico sin afectar al código subyacente.Para eliminar un nodo, seleccione el nodo, y después presione la tecla eliminar.Al eliminar nodos, sus definiciones se quitan del archivo DGML (.dgml).
Al eliminar nodos de un grupo, el botón Volver a obtener elementos secundarios se produce dentro del grupo.Para recuperar nodos que falta, elija Volver a obtener elementos secundarios.Los gráficos creados editando el DGML, agregar nodos sin definir, o con versiones anteriores de Visual Studio Ultimate, no admiten esta funcionalidad.
Precaución |
---|
Antes de compartir un gráfico creado con Visual Studio Ultimate con los que usan Visual Studio Premium o Visual Studio Professional, asegúrese de que cualquier nodo que desee otros para ver está visible en el gráfico.Si no, los usuarios no podrán recuperar nodos eliminados. |
Agrupe los nodos
Para |
Siga estos pasos |
---|---|
Muestre los nodos del contenedor como nodos o del grupo |
Para mostrar los nodos del contenedor como nodos hoja, seleccione los nodos.Abra el menú contextual para la selección.Elija Grupo, Convertir en hoja. Para mostrar los nodos del contenedor como nodos de grupo, seleccione los nodos.Abra el menú contextual para la selección.Elija Grupo, Convertir en grupo. Para mostrar todos los nodos hoja como nodos de grupo, abra el menú contextual para el gráfico.Elija Grupo, Activar agrupación. Para mostrar todos los nodos hoja como nodos de grupo, abra el menú contextual para el gráfico.Elija Grupo, Activar agrupación. |
Agregue un nodo al grupo |
Arrastre el nodo al grupo. También puede arrastrar los nodos de un grupo. |
Agregue un nodo a un nodo sin grupo. |
Puede convertir cualquier nodo en un grupo.Arrastre el nodo hasta el nodo de destino. |
Agrupe los nodos seleccionados |
|
Agrupe los nodos que tienen categorías o propiedades especificas |
|
Agrupar nodos con arreglo a sus valores de propiedad |
|
Quitar grupos |
Seleccione el grupo o los grupos que desee eliminar.Abra el menú contextual para la selección.Elija Grupo, Quitar grupo. |
Quitar nodos desde el grupo primario hasta el grupo primario principal o fuera del grupo si no hay ningún grupo primario principal |
Seleccione los nodos que desea mover.Abra el menú contextual para la selección.Elija Grupo, Eliminar del elemento primario. |
Para agrupar nodos editando el archivo .dgml del gráfico
Para convertir un nodo en un grupo, abra el menú contextual para el nodo.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.
O bien
Para agregar un nuevo grupo:
Abrir el menú contextual del área en blanco del gráfico.Elija Ir a, dgml.
En la sección <Node/>, agregue un nuevo elemento <Nodes>.
En el elemento <Node/>, agregue un atributo Group para especificar si el grupo aparece contraído o expandido.Por ejemplo:
<Nodes> <Node Id="MyFirstGroup" Group="Expanded" /> <Node Id="MySecondGroup" Group="Collapsed" /> </Nodes>
En la sección <Links>, asegúrese de que existe un elemento <Link/> con los atributos siguientes para cada relación entre un nodo de grupo y sus nodos secundarios:
Un atributo Source que especifica el nodo de grupo
Un atributo Target que especifica el nodo secundario
Un atributo Category que especifica una relación Contains entre el nodo de grupo y su nodo secundario
Por ejemplo:
<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 obtener más información sobre el atributo Category, vea Asignar categorías a nodos y vínculos.
Combinar gráficos
Puede combinar gráficos copiando y pegando nodos entre gráficos.Si coinciden los identificadores de nodo, los nodos de pegar funcionan como una operación de combinación.Para crear esta tarea más fácil, coloque todos los ensamblados o binarios que desea visualizar en la misma carpeta de modo que la ruta de acceso completa de cada ensamblado o binario es el mismo para cada gráfico que desee combinar.
Alternativamente, puede crear un único gráfico para los ensamblados o binarios que desea visualizar siguiendo uno de estos pasos:
Arrastre los ensamblados o binarios al mismo gráfico.
O bien
explorador de arquitectura abierta.En Sistema de archivos, elija Seleccionar archivos para examinar, seleccione, y abren los ensamblados o binarios.Para refinar el gráfico, elementos específicos select que desea visualizar.Cuando termine, elija Cree un nuevo documento de gráfico de todos los nodos seleccionados en la barra de herramientas explorador de arquitectura.
Cambiar el estilo del gráfico
Puede cambiar el color de fondo y el color del borde del gráfico editando el archivo .dgml del gráfico.Para cambiar el estilo de los nodos y los vínculos, vea Cambiar el estilo de los nodos y vínculos.
Abrir el menú contextual de la superficie del gráfico.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico.
En el elemento <DirectedGraph>, agregue cualquiera de los siguientes atributos para cambiar el estilo:
Para cambiar el
Agregue el atributo siguiente
Color de fondo
Background="ColorNameOrHexadecimalValue"
Color del borde
Stroke="StrokeValue"
Por ejemplo:
<DirectedGraph Background="Green" xmlns="https://schemas.microsoft.com/vs/2009/dgml" > ... ... </DirectedGraph>
Cambiar el estilo de los nodos y vínculos
Puede cambiar los iconos de los nodos y los colores de los nodos y los vínculos.Puede usar colores e iconos predefinidos o especificar unos personalizados editando el archivo .dgml del gráfico.Vea Aplicar estilos personalizados a nodos y vínculos.
Por ejemplo, puede elegir un color para resaltar los nodos y los vínculos que tengan cierta categoría o propiedad.De este modo, podrá identificar áreas específicas del gráfico y concentrarse en ellas.
Para aplicar un color o icono predefinido a los nodos cierta categoría o propiedad
Si el cuadro Leyenda no está visible, abra el menú contextual para el gráfico.Elija Mostrar leyenda.
En el cuadro Leyenda, vea si la categoría o propiedad del nodo aparece en la lista.
Si la lista no incluye la categoría o propiedad, elija + en el cuadro Leyenda, Categoría de nodo o Propiedad de nodo, y la categoría o propiedad.
La categoría o propiedad aparece ahora en el cuadro Leyenda.
[!NOTA]
Para crear y asignar una categoría a un nodo, vea Asignar categorías a nodos y vínculos.Crear y asignar una propiedad a un nodo, vea Asignar propiedades a nodos y vínculos.
En el cuadro Leyenda, abra la lista desplegable situada junto a la categoría o propiedad.
Use la tabla siguiente para seleccionar el estilo que desea cambiar:
Para cambiar el
Choose
Color de fondo
Background
Color del contorno
Trazo
Color del texto
Foreground
Iconos
Iconos
El cuadro Selector de conjunto de colores aparece para seleccionar un color (o icono).
En el cuadro de diálogo Selector de conjunto de colores, realice uno de los siguientes:
Para aplicar a
Siga estos pasos
Conjunto de colores (o iconos
Abra la lista Color seleccione (o icono) establecer.Seleccione un conjunto de colores (o iconos).
Para volver al color (o icono) predeterminado, en la lista Color seleccione (icono) establecer, elija Ninguno.
Color (o icono) específico
Abra la lista de categorías o de valor de propiedad.Seleccione un color (o icono).
[!NOTA]
Puede reorganizar, eliminar o desactivar temporalmente los estilos en el cuadro Leyenda.Vea Modificar el cuadro leyenda.
Para aplicar un color predefinido a los vínculos con una determinada categoría o propiedad
Si el cuadro Leyenda no está visible, abra el menú contextual para el gráfico.Elija Mostrar leyenda.
En el cuadro Leyenda, observe si la categoría o propiedad aparece en la lista.
Si la lista no incluye la categoría o propiedad, elija + en el cuadro Leyenda, Categoría de vínculo o Propiedad de vínculo, y la categoría o propiedad.
La categoría o propiedad aparece ahora en el cuadro Leyenda.
[!NOTA]
Para crear y asignar una categoría a un vínculo, vea Asignar categorías a nodos y vínculos.Para crear y asignar una propiedad a un vínculo, vea Asignar propiedades a nodos y vínculos.
En el cuadro Leyenda, abra la lista situada al lado de la categoría o propiedad.
Trazo Seleccione para cambiar el esquema y la punta de flecha el color del vínculo.
El cuadro Selector de conjunto de colores aparece para seleccionar un color.
En el cuadro Selector de conjunto de colores, realice uno de los siguientes:
Para aplicar a
Siga estos pasos
Conjunto de colores
Abra la lista Color seleccioneestablecer.Seleccione un conjunto de colores.
Para volver al color predeterminado, en la lista Seleccionar conjunto de colores, elija Ninguno.
Color específico
Abra la lista de valores de propiedad para seleccionar un color.
[!NOTA]
Puede reorganizar, eliminar o desactivar temporalmente los estilos en el cuadro Leyenda.Vea Modificar el cuadro leyenda.
Aplicar estilos personalizados a nodos y vínculos
Puede aplicar estilos personalizados a los siguientes elementos:
Nodos y vínculos únicos
Grupos de nodos y vínculos
Grupos de nodos y vínculos de acuerdo con ciertas condiciones
Para aplicar un estilo personalizado a un único nodo
Abrir el menú contextual del nodo cuyo estilo desea personalizar.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.
En el elemento <Node/>, agregue cualquiera de los siguientes atributos para personalizar el estilo:
Para cambiar el
Agregue el atributo siguiente
Color de fondo
Background="ColorNameOrHexadecimalValue"
Contorno
Stroke="ColorNameOrHexadecimalValue"
Grosor del contorno
StrokeThickness="StrokeValue"
Color del texto
Foreground="ColorNameOrHexadecimalValue"
Iconos
Icon="IconFilePathLocation"
Tamaño del texto
FontSize="FontSizeValue"
Tipo de texto
FontFamily="FontFamilyName"
Grosor del texto
FontWeight="FontWeightValue"
Estilo del texto
FontStyle="FontStyleName"
Por ejemplo, puede especificar Italic como estilo de texto.
Textura
Style="Glass"
-O bien-
Style="Plain"
Forma
Para reemplazar la forma con un icono, establezca la propiedad de Shape a None y establezca la propiedad de Icon a la ruta con el archivo de icono.
Shape="ShapeFilePathLocation"
Por ejemplo:
<Nodes> <Node Id="MyNode" Background="#FF008000" Stroke="#FF000000" Foreground="#FFFFFFFF" Icon="...\Icons\Globe.png"/> </Nodes>
Para aplicar un estilo personalizado a un único vínculo
En el gráfico, mueva el puntero sobre el vínculo.Una información sobre herramientas aparece e identifica el nodo de origen y el nodo de destino del vínculo.(El teclado: PresioneTab hasta el foco está en el vínculo.)
Abrir el menú contextual para el gráfico.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico.
Busque el elemento <Link/> que contiene el nombre del nodo de origen y el nombre del nodo de destino.
En el elemento <Link/>, agregue cualquiera de los siguientes atributos para personalizar el estilo:
Para cambiar el
Agregue el atributo siguiente
Contorno y punta de flecha color
Stroke="ColorNameOrHexadecimalValue"
Grosor del contorno
StrokeThickness="StrokeValue"
Estilo del contorno
StrokeDashArray="StrokeArrayValues"
Por ejemplo:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Background="Green" Stroke="#FF000000" StrokeDashArray="2,2"/> </Links>
Para aplicar estilos personalizados a un grupo de nodos o vínculos
Asigne cualquier categoría o propiedad que desee a los nodos o vínculos.
Sugerencia Si tiene estilos extensibles en varios nodos o vínculos, podría considerar aplicar una categoría a los nodos o vínculos, y después aplicar un estilo a esa categoría.Para obtener más información, vea Asignar categorías a nodos y vínculos y Asignar propiedades a nodos y vínculos.
Abra el menú contextual para la superficie del gráfico.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico.
Si no existe ningún elemento <Styles></Styles>, agregue uno bajo el elemento <DirectedGraph></DirectedGraph>, detrás del elemento <Links></Links>.
En el elemento <Styles></Styles>, bajo el elemento <Style/>, especifique los atributos siguientes:
TargetType="Node | Link | Graph"
GroupLabel="NameInLegendBox"
ValueLabel="NameInStylePickerBox"
Para aplicar un estilo personalizado a todos los tipos de destino, no use ninguna condición.
Para aplicar un estilo condicional a los grupos de nodos o vínculos
En el elemento <Style/>, agregue un elemento <Condition/> que contenga un atributo Expression para especificar una expresión que devuelva un valor booleano.
Por ejemplo:
<Condition Expression="MyCategory"/>
-O bien-
<Condition Expression="MyCategory > 100"/>
-O bien-
<Condition Expression="HasCategory('MyCategory')"/>
Esta expresión usa la sintaxis de la forma de Backus-Naur (BNF) siguiente:
<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> ::= literal de cadena entre comillas simples o dobles
<Number> ::= cadena de dígitos con separador decimal opcional
Puede especificar varios elementos de <Condition/>, que deben ser true para aplicar el estilo.
En la línea que sigue al elemento <Condition/>, agregue uno o varios elementos <Setter/> para especificar un atributo Property y un atributo Value fijo o un atributo Expression calculado para aplicarlo al gráfico, los nodos o los vínculos que satisfacen la condición.
Por ejemplo:
<Setter Property="BackGround" Value="Green"/>
En este sencillo ejemplo completo que se muestra a continuación, la condición especifica que un nodo debe aparecer en verde o en rojo en función de si su categoría Passed está establecida en True o 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>
En la tabla siguiente se incluyen algunas condiciones de ejemplo que puede usar:
Modificar el cuadro Leyenda
Puede reorganizar, eliminar o desactivar temporalmente los estilos en el cuadro Leyenda:
Abrir el menú contextual para un estilo en el cuadro Leyenda.
Realice una de las tareas siguientes:
Para
Choose
Subir el estilo
Subir
Bajar el elemento
Bajar
Eliminar el elemento
Eliminar
Desactivar el elemento
Deshabilitar
Reactivar el elemento
Habilitar
Copiar estilos de un gráfico a otro
Asegúrese de que el cuadro Leyenda aparece en el gráfico de origen.Si no está visible, abra el menú contextual para un área en blanco del gráfico de origen.Elija Mostrar leyenda.
Abrir el menú contextual para el cuadro Leyenda.Elija Leyenda de copia.
Pegue la leyenda en el gráfico de destino.
Asignar propiedades a nodos y vínculos
Puede organizar los nodos y vínculos asignándoles propiedades.Por ejemplo, puede seleccionar nodos que tengan propiedades concretas para que pueda agruparlos, cambiar su estilo u ocultarlos.
Para asignar una propiedad a un nodo
Abra el menú contextual para el nodo.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.
En el elemento <Node/>, especifique el nombre de la propiedad y su valor.Por ejemplo:
<Nodes> <Node Id="MyNode" MyPropertyName="PropertyValue" /> </Nodes>
Agregue un elemento <Property/> a la sección <Properties> para especificar atributos, como el nombre visible y el tipo de datos:
<Properties> <Property Id="MyPropertyName" Label="My Property" DataType="System.DataType"/> </Properties>
Para asignar una propiedad a un vínculo
En el gráfico, mueva el puntero sobre el vínculo.Una información sobre herramientas aparece e identifica el nodo de origen y el nodo de destino del vínculo.(El teclado: Presione Tab hasta que el foco esté en el vínculo.)
Abrir el menú contextual para el gráfico.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico.
Busque el elemento <Link/> que contiene el nombre del nodo de origen y el nombre del nodo de destino.
En el elemento <Node/>, especifique el nombre de la propiedad y su valor.Por ejemplo:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" /> </Links>
Agregue un elemento <Property/> a la sección <Properties> para especificar atributos, como el nombre visible y el tipo de datos:
<Properties> <Property Id="MyPropertyName" Label="My Property Name" DataType="System.DataType"/> </Properties>
Asignar categorías a nodos y vínculos
Puede organizar los nodos asignándoles categorías.Por ejemplo, puede seleccionar nodos que pertenezcan a determinadas categorías para que pueda agruparlos, cambiar su estilo u ocultarlos.Puede resaltar los vínculos que tengan ciertas categorías.Para obtener más información, vea las secciones siguientes:
Agrupe los nodos
Cambiar el estilo de los nodos y vínculos
Ocultar o mostrar nodos
Para asignar una categoría a un nodo
- Para asignar una categoría predefinida, como la Categoría 1, abra el menú contextual para el nodo.Elija Clasificar y una categoría predefinida.
-O bien-
Para crear y asignar una categoría personalizada:
- Elija el nodo que desea clasificar.Presione F4 a abrir la ventana propiedades.Escriba el nombre de categoría en la propiedad Nueva categoría de nodo.Presione ENTRAR.
-O bien-
Abra el menú contextual para el nodo.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.
En el elemento <Node/>, agregue un atributo Category para especificar el nombre de la categoría.Por ejemplo:
<Nodes> <Node Id="MyNode" Category="MyCategory" /> </Nodes>
Agregue un elemento <Category/> a la sección <Categories> de modo que pueda usar el atributo Label con el fin de especificar el texto visualizado de esa categoría:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
Para asignar una categoría a un vínculo
En el gráfico, mueva el puntero del mouse sobre el vínculo para mostrar la información sobre herramientas e identificar el nodo de origen y el nodo de destino del vínculo.(El teclado: Presione Tab hasta que el foco esté en el vínculo.)
Abrir el menú contextual para el gráfico.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico.
Busque el elemento <Link/> que contiene el nombre del nodo de origen y el nombre del nodo de destino.
En el elemento <Link/>, agregue un atributo Category para especificar el nombre de la categoría.Por ejemplo:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory" </Links>
Agregue un elemento <Category/> a la sección <Categories> de modo que pueda usar el atributo Label con el fin de especificar el texto visualizado de esa categoría:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
Puede crear categorías jerárquicas que le ayuden a organizar los nodos y a agregar atributos a categorías secundarias usando la relación de herencia.
Para crear categorías jerárquicas
Agregue un elemento <Category/> de la categoría primaria y, a continuación, agregue el atributo BasedOn al elemento <Category/> de la categoría secundaria.
Por ejemplo:
<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>
En este ejemplo, el fondo de MyFirstNode es verde porque su atributo Category hereda el atributo Background de MyParentCategory.
Vincular elementos a nodos o vínculos
Puede vincular elementos, como documentos o direcciones URL, a un nodo o vínculo editando el archivo .dgml del gráfico y agregando un atributo de Reference al elemento de <Node/> para un nodo o elemento de <Link/> para un vínculo.Puede abrir y ver el contenido del nodo o del vínculo.El atributo Reference especifica la ruta de acceso del contenido.Puede tratarse de una ruta de acceso absoluta o de una ruta de acceso relativa a la ubicación del archivo .dgml.
Precaución |
---|
Si utiliza rutas de acceso relativas, y el archivo .dgml se mueve a otra ubicación, después las rutas resolverá ya no.Al intentar abrir y ver el contenido vinculado, un error que indica que el contenido no pueden verse aparecerá. |
Por ejemplo, quizá desee vincular los elementos siguientes:
Para describir los cambios de una clase, puede vincular la dirección URL de un elemento de trabajo, documento u otro archivo .dgml al nodo de una clase.
Podría vincular un diagrama de capas a un nodo de grupos que representa una capa en la arquitectura lógica del software.
Para mostrar más información sobre un componente que expone una interfaz, puede vincular un diagrama de componentes al nodo de esa interfaz.
Vincule un nodo a un elemento de trabajo o error de Team Foundation Server, o alguna otra información relacionada con el nodo.
Para vincular un elemento a un nodo
En el gráfico, abra el menú contextual para el nodo.Elija Ir a, dgml.
Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.
Realice una de las tareas de la tabla siguiente:
Para vincular
Siga estos pasos
Un elemento único
En el elemento de <Node/> o de <Link/>, agregue un atributo de Reference para especificar la ubicación del elemento.
NotaPuede tener un atributo de Reference por el elemento.
Por ejemplo:
<Nodes> <Node Id="MyNode" Reference="MyDocument.txt" /> </Nodes> <Properties> <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" /> </Properties>
Varios elementos
En el elemento de <Node/> o de <Link/>, agregue un nuevo atributo para especificar la ubicación de cada referencia.
En la sección <Properties>:
Agregue un elemento <Property/> para cada nuevo tipo de referencia.
Establezca al atributo Id en el nombre del nuevo atributo de referencia.
Agregue el atributo de IsReference y establézcalo en True para hacer que la referencia aparece en el menú contextual ir a al elemento.
Utilice el atributo de Label para especificar el texto visualizado en el menú contextual ir a al elemento.
Por ejemplo:
<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>
En el gráfico, el nombre del nodo aparece subrayado.Al abrir el menú contextual para el nodo o vínculo, verá un menú contextual ir a que contiene los elementos vinculados para elegir.
Use el atributo ReferenceTemplate para especificar una cadena común, como una dirección URL, que se use en varias referencias en lugar de repetir esa cadena en la referencia.
El atributo ReferenceTemplate especifica un marcador de posición para el valor de la referencia.En el ejemplo siguiente, el marcador de posición {0} del atributo ReferenceTemplate se reemplazará por los valores de los atributos MyFirstReference y MySecondReference del elemento <Node/> para generar una ruta de acceso completa:
<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 ver el elemento o elementos a los que se hace referencia de dibujo, abra el menú contextual para el nodo o vínculo.Elija ir a continuación el elemento.
Crear alias para rutas de acceso usadas con frecuencia
El reemplazo de rutas de acceso usadas con frecuencia con alias ayuda a reducir el tamaño del archivo .dgml y el tiempo necesario para cargar o guardar el archivo.Para crear un alias, agregue una sección <Paths></Paths> al final del archivo .dgml.En esta sección, agregue un elemento <Path/> para definir un alias para la ruta de acceso:
<Paths>
<Path Id="MyPathAlias" Value="C:\...\..." />
</Paths>
Para hacer referencia al alias desde un elemento del archivo .dgml, rodee el valor Id del elemento <Path/> con un signo de dólar ($) y paréntesis (()):
<Nodes>
<Node Id="MyNode" Reference="$(MyPathAlias)MyDocument.txt" />
</Nodes>
<Properties>
<Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" />
</Properties>
Introducción a Directed Graph Markup Language (DGML)
DGML usa XML simple para describir los gráficos dirigidos cíclicos y acíclicos.Un gráfico dirigido es un conjunto de nodos que están conectados mediante vínculos, o bordes.Se pueden usar nodos y vínculos para representar estructuras de red, como elementos en un proyecto de software.Use DGML para visualizar información, realizar análisis de complejidad o simplemente examinar y editar gráficos dirigidos.
Los nodos y vínculos se llaman elementos de gráfico o solo elementos.En la tabla siguiente se describen los tipos de elementos que se emplean en DML:
[!NOTA]
Al editar un archivo .dgml, IntelliSense le ayuda a identificar los atributos disponibles para cada elemento y sus valores.Para especificar color en un atributo, use nombres para los colores comunes, como "Blue", o valores hexadecimales de ARGB, como "#ffa0b1c3".DGML emplea un pequeño subconjunto de los formatos de definición de color de Windows Presentation Foundation (WPF).Para obtener más información, vea Colors Class.
Elemento |
Formato de ejemplo |
---|---|
<DirectedGraph></DirectedGraph> Este elemento es el elemento raíz de un documento de gráfico dirigido (.dgml).Todos los demás elementos de DGML aparecen dentro del ámbito de este elemento. En la lista siguiente se describen atributos opcionales que puede incluir:
|
|
<Nodes></Nodes> Este elemento opcional contiene una lista de elementos <Node/>, que definen nodos del gráfico.Para obtener más información, vea el elemento <Node/>.
Nota
Al hacer referencia a un nodo no definido en un elemento <Link/>, el gráfico crea un elemento <Node/> automáticamente.
|
|
<Node/> Este elemento define un único nodo.Aparece dentro de la lista de elementos <Nodes><Nodes/>. Este elemento debe incluir los atributos siguientes:
En la lista siguiente se describen algunos atributos opcionales que puede incluir:
|
|
<Links></Links> Este elemento contiene la lista de elementos <Link>, que definen vínculos entre nodos.Para obtener más información, vea el elemento <Link/>. |
|
<Link/> Este elemento define un único vínculo que conecta un nodo de origen con un nodo de destino.Aparece dentro de la lista de elementos <Links></Links>.
Nota
Si este elemento hace referencia a un nodo no definido, el documento de gráfico crea automáticamente un nodo que tiene los atributos especificados, si existe.
Este elemento debe incluir los atributos siguientes:
En la lista siguiente se describen algunos atributos opcionales que puede incluir:
|
|
<Categories></Categories> Este elemento contiene la lista de elementos <Category/>.Para obtener más información, vea el elemento <Category/>. |
|
<Category/> Este elemento define un atributo Category, que se emplea para identificar elementos que comparten este atributo.Se puede usar un atributo Category para organizar elementos de gráfico, proporcionar atributos compartidos a través de la herencia o definir metadatos adicionales. Este elemento debe incluir los atributos siguientes:
En la lista siguiente se describen algunos atributos opcionales que puede incluir:
Las categorías también proporcionan cierto comportamiento de plantilla básico que controla la apariencia de los nodos y vínculos cuando se muestran en un gráfico.Vea Aplicar estilos personalizados a nodos y vínculos. |
|
<Properties></Properties> Este elemento contiene la lista de elementos <Property/>.Para obtener más información, vea el elemento <Property/>. |
|
<Property/> Este elemento define un atributo Property que puede usar para asignar un valor a cualquier elemento de DGML o atributo, incluyendo categorías y otras propiedades. Este elemento debe incluir los atributos siguientes:
Si desea que la propiedad aparezca en la ventana Propiedades, use la propiedad Label para especificar el nombre para mostrar de la propiedad. Vea Asignar propiedades a nodos y vínculos. |
|
Vea también
Conceptos
Visualizar dependencias de código en gráficos de dependencias