Tip Over Tree Layout Example for Blazor

Nevron NOV Diagram for Blazor ships with hundreds of examples with full source code, as part of the Nevron Open Vision Suite. All Blazor Diagram examples are also available as a stand-alone Visual Studio solution in C#, which you can download from the links below.

Tip Over Tree Layout Example for Blazor Description

The tip-over tree layout is a tree layout, which uses shapes provided data to determine whether the vertex children should be placed in a row, column or 2 columns. It produces orthogonal tree drawings. The layout satisfies to the following aesthetic criteria:

  • No edge crossings - edges do not cross each other.
  • No vertex-vertex overlaps - vertices do not overlap each other.
  • No vertex-edge overlaps - vertices do not overlap edges.
  • Compactness - you can optimize the compactness of the drawing in both the breadth and depth dimensions of the tree by setting the Compact property to true.

You can change the way the children and the leafs are placed using the corresponding properties. You can also set the children placement for the children of each vertex individually using the TipOverChildrenPlacement property in the LayoutData collection of the shape.

This type of layout is typically used in Org Charts, but can also be used in all cases where classical tree layouts (e.g. layouts with uniform parent placement) do not produce width/height ratio compact results.

In this example the nodes whose children are arranged in cols are highlighted with orange.

To experiment with the layout just change its properties from the property grid and click the Layout button. To see the layout in action on a different trees, just click the Random Tree button.


Tip over Tree Layout Example

C# Tip Over Tree Layout Example Code for Nevron Diagram for Blazor
Language: C#

using Nevron.Nov;
using Nevron.Nov.DataStructures;
using Nevron.Nov.Diagram;
using Nevron.Nov.Diagram.Layout;
using Nevron.Nov.Diagram.Shapes;
using Nevron.Nov.Dom;
using Nevron.Nov.Editors;
using Nevron.Nov.Graphics;
using Nevron.Nov.Layout;
using Nevron.Nov.UI;
using Nevron.Nov.Windows.Forms;
using System;
using System.Windows.Forms;

namespace NovWinFormsProject
{
	public partial class Form1 : Form
	{
		#region Constructors

		public Form1()
		{
			InitializeComponent();

			// Set form title
			Text = "NOV WinForms - NTipOverTreeLayoutExample";

			// Create the NOV example and its controls
			NWidget exampleContent = CreateExampleContent();
			NWidget exampleControls = CreateExampleControls();
			if (exampleControls != null)
			{
				exampleControls.PreferredWidth = 300;
			}

			// Place the example and its controls in a pair box
			NPairBox pairBox = new NPairBox(exampleContent, exampleControls);
			pairBox.FillMode = ENStackFillMode.First;
			pairBox.FitMode = ENStackFitMode.First;
			pairBox.Margins = new NMargins(NDesign.HorizontalSpacing, NDesign.VerticalSpacing);

			// Host the example in the form
			NNovWidgetHost host = new NNovWidgetHost(pairBox);
			host.Dock = DockStyle.Fill;
			Controls.Add(host);
		}

		#endregion

        #region Example

        public NWidget CreateExampleContent()
        {
            // Create a simple drawing
            NDrawingViewWithRibbon drawingViewWithRibbon = new NDrawingViewWithRibbon();
            m_DrawingView = drawingViewWithRibbon.View;

            m_DrawingView.Document.HistoryService.Pause();
            try
            {
                InitDiagram(m_DrawingView.Document);
            }
            finally
            {
                m_DrawingView.Document.HistoryService.Resume();
            }

            return drawingViewWithRibbon;
        }
        public NWidget CreateExampleControls()
        {
            m_Layout.Changed += OnLayoutChanged;

            NStackPanel stack = new NStackPanel();

            // property editor
            NEditor editor = NDesigner.GetDesigner(m_Layout).CreateStandaloneEditor(m_Layout);
            stack.Add(new NGroupBox("Properties", editor));

            NButton arrangeButton = new NButton("Arrange Diagram");
            arrangeButton.Click += OnArrangeButtonClick;
            stack.Add(arrangeButton);

            // items stack
            NStackPanel itemsStack = new NStackPanel();

            // NOTE: For Tree layouts we provide the user with the ability to generate random tree diagrams so that he/she can test the layouts
            NButton randomTree1Button = new NButton("Random Tree (max 6 levels, max 3 branch nodes)");
            randomTree1Button.Click += OnRandomTree1ButtonClick;
            itemsStack.Add(randomTree1Button);

            NButton randomTree2Button = new NButton("Random Tree (max 8 levels, max 2 branch nodes)");
            randomTree2Button.Click += OnRandomTree2ButtonClick;
            itemsStack.Add(randomTree2Button);

            stack.Add(new NGroupBox("Items", itemsStack));

            return stack;
        }
        public string GetExampleDescription()
        {
            return @"

The tip-over tree layout is a tree layout, which uses shapes provided data to determine whether the vertex children should be placed in a row, column or 2 columns. It produces orthogonal tree drawings. The layout satisfies to the following aesthetic criteria:

  • No edge crossings - edges do not cross each other.
  • No vertex-vertex overlaps - vertices do not overlap each other.
  • No vertex-edge overlaps - vertices do not overlap edges.
  • Compactness - you can optimize the compactness of the drawing in both the breadth and depth dimensions of the tree by setting the Compact property to true.

You can change the way the children and the leafs are placed using the corresponding properties. You can also set the children placement for the children of each vertex individually using the TipOverChildrenPlacement property in the LayoutData collection of the shape.

This type of layout is typically used in Org Charts, but can also be used in all cases where classical tree layouts (e.g. layouts with uniform parent placement) do not produce width/height ratio compact results.

In this example the nodes whose children are arranged in cols are highlighted with orange.

To experiment with the layout just change its properties from the property grid and click the Layout button. To see the layout in action on a different trees, just click the Random Tree button.

"; } /// /// Gets the relevant documentation links for the example /// /// public (string Name, string Url)[] GetDocumentationUrls() { return new[] { ("Tip-over Tree Layout", "https://www.nevron.com/docs/openvision/diagram-tip-over-tree-layout.html"), ("Layouts Overview", "https://www.nevron.com/docs/openvision/diagram-drawing-layouts-overview.html"), ("Graph Regions and Regions Layouts", "https://www.nevron.com/docs/openvision/diagram-graph-regions-and-region-layouts.html"), }; } private void InitDiagram(NDrawingDocument drawingDocument) { const double ShapeWidth = 120; const double ShapeHeight = 60; // Hide ports drawingDocument.Content.ScreenVisibility.ShowPorts = false; NPage activePage = drawingDocument.Content.ActivePage; // We will be using basic shapes with default size of 120, 60 NBasicShapeFactory basicShapes = new NBasicShapeFactory(); basicShapes.DefaultSize = new NSize(ShapeWidth, ShapeHeight); // Create the president NShape president = basicShapes.CreateShape(ENBasicShape.Rectangle); president.Text = "President"; activePage.Items.Add(president); // Create the VPs. // NOTE: The child nodes of the VPs are layed out in cols NShape vpMarketing = basicShapes.CreateShape(ENBasicShape.Rectangle); vpMarketing.Text = "VP Marketing"; vpMarketing.Geometry.Stroke = new NStroke(1, new NColor(68, 90, 108)); vpMarketing.LayoutData.TipOverChildrenPlacement = ENTipOverChildrenPlacement.ColRight; activePage.Items.Add(vpMarketing); NShape vpSales = basicShapes.CreateShape(ENBasicShape.Rectangle); vpSales.Text = "VP Sales"; vpSales.Geometry.Stroke = new NStroke(1, new NColor(68, 90, 108)); vpSales.LayoutData.TipOverChildrenPlacement = ENTipOverChildrenPlacement.ColRight; activePage.Items.Add(vpSales); NShape vpProduction = basicShapes.CreateShape(ENBasicShape.Rectangle); vpProduction.Text = "VP Production"; vpSales.LayoutData.TipOverChildrenPlacement = ENTipOverChildrenPlacement.ColRight; vpProduction.Geometry.Stroke = new NStroke(1, new NColor(68, 90, 108)); activePage.Items.Add(vpProduction); // Connect president with VP NRoutableConnector connector = new NRoutableConnector(); activePage.Items.Add(connector); connector.GlueBeginToShape(president); connector.GlueEndToShape(vpMarketing); connector = new NRoutableConnector(); activePage.Items.Add(connector); connector.GlueBeginToShape(president); connector.GlueEndToShape(vpSales); connector = new NRoutableConnector(); activePage.Items.Add(connector); connector.GlueBeginToShape(president); connector.GlueEndToShape(vpProduction); // Create the marketing managers NShape marketingManager1 = basicShapes.CreateShape(ENBasicShape.Rectangle); marketingManager1.Text = "Manager1"; activePage.Items.Add(marketingManager1); NShape marketingManager2 = basicShapes.CreateShape(ENBasicShape.Rectangle); marketingManager2.Text = "Manager2"; activePage.Items.Add(marketingManager2); // Connect the marketing manager with the marketing VP connector = new NRoutableConnector(); activePage.Items.Add(connector); connector.GlueBeginToShape(vpMarketing); connector.GlueEndToShape(marketingManager1); connector = new NRoutableConnector(); activePage.Items.Add(connector); connector.GlueBeginToShape(vpMarketing); connector.GlueEndToShape(marketingManager2); // Create the sales managers NShape salesManager1 = basicShapes.CreateShape(ENBasicShape.Rectangle); salesManager1.Text = "Manager1"; activePage.Items.Add(salesManager1); NShape salesManager2 = basicShapes.CreateShape(ENBasicShape.Rectangle); salesManager2.Text = "Manager2"; activePage.Items.Add(salesManager2); // Connect the sales manager with the sales VP connector = new NRoutableConnector(); activePage.Items.Add(connector); connector.GlueBeginToShape(vpSales); connector.GlueEndToShape(salesManager1); connector = new NRoutableConnector(); activePage.Items.Add(connector); connector.GlueBeginToShape(vpSales); connector.GlueEndToShape(salesManager2); // Create the production managers NShape productionManager1 = basicShapes.CreateShape(ENBasicShape.Rectangle); productionManager1.Text = "Manager1"; activePage.Items.Add(productionManager1); NShape productionManager2 = basicShapes.CreateShape(ENBasicShape.Rectangle); productionManager2.Text = "Manager2"; activePage.Items.Add(productionManager2); // Connect the production manager with the production VP connector = new NRoutableConnector(); activePage.Items.Add(connector); connector.GlueBeginToShape(vpProduction); connector.GlueEndToShape(productionManager1); connector = new NRoutableConnector(); activePage.Items.Add(connector); connector.GlueBeginToShape(vpProduction); connector.GlueEndToShape(productionManager2); // Arrange diagram ArrangeDiagram(drawingDocument); // Fit active page drawingDocument.Content.ActivePage.ZoomMode = ENZoomMode.Fit; } #endregion #region Implementation private void CreateTreeDiagram(NDrawingDocument drawingDocument, int levels, int branchNodes) { // Create a random tree NGenericTreeTemplate tree = new NGenericTreeTemplate(); tree.EdgeUserClass = NDR.StyleSheetNameConnectors; tree.Balanced = false; tree.Levels = levels; tree.BranchNodes = branchNodes; tree.HorizontalSpacing = 10; tree.VerticalSpacing = 10; tree.VertexShape = VertexShape; tree.VertexSize = VertexSize; tree.VertexSizeDeviation = 1; tree.Create(drawingDocument); // Randomly set the children placement of ten shapes to col NList shapes = drawingDocument.Content.ActivePage.GetShapes(false, NDiagramFilters.ShapeType2D); Random random = new Random(); for (int i = 0; i < shapes.Count / 2; i++) { int index = random.Next(shapes.Count); NShape shape = shapes[index]; shape.Geometry.Fill = new NColorFill(NColor.Orange); shape.LayoutData.TipOverChildrenPlacement = ENTipOverChildrenPlacement.ColRight; } } /// /// Arranges the shapes in the active page. /// /// private void ArrangeDiagram(NDrawingDocument drawingDocument) { // get all top-level shapes that reside in the active page NPage activePage = drawingDocument.Content.ActivePage; NList shapes = activePage.GetShapes(false); // create a layout context and use it to arrange the shapes using the current layout NDrawingLayoutContext layoutContext = new NDrawingLayoutContext(drawingDocument, activePage); m_Layout.Arrange(shapes.CastAll(), layoutContext); // size the page to the content size activePage.SizeToContent(); } #endregion #region Event Handlers private void OnLayoutChanged(NEventArgs arg) { ArrangeDiagram(m_DrawingView.Document); } private void OnArrangeButtonClick(NEventArgs arg) { ArrangeDiagram(m_DrawingView.Document); } private void OnRandomTree1ButtonClick(NEventArgs arg) { m_DrawingView.ActivePage.Items.Clear(); // create a random tree CreateTreeDiagram(m_DrawingView.Document, 6, 3); // layout the tree ArrangeDiagram(m_DrawingView.Document); } private void OnRandomTree2ButtonClick(NEventArgs arg) { m_DrawingView.ActivePage.Items.Clear(); // create a random tree CreateTreeDiagram(m_DrawingView.Document, 8, 2); // layout the tree ArrangeDiagram(m_DrawingView.Document); } #endregion #region Fields private NDrawingView m_DrawingView; private NTipOverTreeLayout m_Layout = new NTipOverTreeLayout(); #endregion #region Static Methods #endregion #region Constants private const ENBasicShape VertexShape = ENBasicShape.Rectangle; private static readonly NSize VertexSize = new NSize(60, 60); #endregion #region Nested Types #endregion } }

Download a fully functional C# (.cs) Tip Over Tree Layout Example for Blazor Solution