Tutorial 2: Loading Hierarchical Data

This tutorial shows how to load hierarchical data recursively from XML and create diagram items corresponding to the hierarchy. It assumes you have already integrated the diagram library into your project, as shown in Getting Started guide.

1. Right-click the Assets folder in Solution Explorer and choose Add -> New Item from the context menu. Create a new XML file called SampleTree.xml and add to it content in the following form:

XML

<?xml version="1.0" encoding="utf-8" ?> 
<Project>
  <Activity Name="Activity 1">
    <Activity Name="sub-activity 1">
      <Activity Name="sub-activity 1-1" />
      <Activity Name="sub-activity 1-2" />
    </Activity>
    <Activity Name="sub-activity 2">
      <Activity Name="sub-activity 2-1" />
      <Activity Name="sub-activity 2-2" />
      <Activity Name="sub-activity 2-3" />
    </Activity>
    <Activity Name="sub-activity 3">
      <Activity Name="sub-activity 3-1" />
      <Activity Name="sub-activity 3-2" />
    </Activity>
  </Activity>
  <Activity Name="Activity 2">
    <Activity Name="sub-activity 1">
      <Activity Name="sub-activity 1-1" />
      <Activity Name="sub-activity 1-2" />
      <Activity Name="sub-activity 1-3" />
    </Activity>
    <Activity Name="sub-activity 2">
      <Activity Name="sub-activity 2-1" />
      <Activity Name="sub-activity 2-2" />
    </Activity>
  </Activity>
  <Activity Name="Activity 3">
    <Activity Name="sub-activity 1">
      <Activity Name="sub-activity 1-1" />
      <Activity Name="sub-activity 1-2" />
      <Activity Name="sub-activity 1-3" />
      <Activity Name="sub-activity 1-4" />
    </Activity>
    <Activity Name="sub-activity 2" />
    <Activity Name="sub-activity 3">
      <Activity Name="sub-activity 3-1" />
      <Activity Name="sub-activity 3-2" />
    </Activity>
  </Activity>
</Project>

2. Make sure that the file's "Build Action" property is set to "Content".
3. Open window's code-behind file, e.g. MainWindow.xaml.cs.
4. Add the following member to the window class to hold the default node size.

C#

Rect nodeBounds = new Rect(0, 0, 110, 20);

5. After InitializeComponent call in window constructor, create the tree's root node, and call the CreateChildren method, which builds the tree recursively.

C#

var root = diagram.Factory.CreateShapeNode(nodeBounds);
root.Text = "Project";
var loc = Windows.ApplicationModel.Package.Current.InstalledPath;
var document = XDocument.Load(loc + "\\Assets\\SampleTree.xml");
CreateChildren(root, document.Element("Project"));

6. Define CreateChildren as follows. It takes as parameters the parent DiagramNode and parent XML element, iterates the child XML elements to build the next level of the hierarchy, and creates corresponding diagram items by calling CreateShapeNode and CreateDiagramLink.

C#

void CreateChildren(DiagramNode parentDiagNode, XElement parentXmlElement)
{
    foreach (var element in parentXmlElement.Elements("Activity"))
    {
        var node = diagram.Factory.CreateShapeNode(nodeBounds);
        node.Text = element.Attribute("Name").Value;
        diagram.Factory.CreateDiagramLink(parentDiagNode, node);
        CreateChildren(node, element);
    }
}

7. Use TreeLayout to arrange the diagram. Add the following code to the end of the window constructor.

C#

var layout = new TreeLayout();
layout.Type = TreeLayoutType.Cascading;
layout.Direction = TreeLayoutDirection.LeftToRight;
layout.LinkStyle = TreeLayoutLinkType.Cascading2;
layout.NodeDistance = 5;
layout.LevelDistance = -25; // let horizontal positions overlap
layout.Arrange(diagram);

8. Build and run the project. If everything is fine, you should see this representation of the hierarchy: