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:
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.

| 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