Table Flow Layout Example for WPF

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

Table Flow Layout Example for WPF Description

The table flow layout arranges cells sequentially in a virtual table. Each lane contains a configurable maximum number of cells, with cells aligned across rows and columns.

The most important properties of this layout are:

  • Direction - determines the flow within each lane: LeftToRight, RightToLeft, TopToBottom, or BottomToTop.
  • Inverted - reverses the order in which lanes are arranged. The default value is false.
  • MaxOrdinal - specifies the maximum number of cells per lane. For horizontal flow, it determines the maximum number of columns. For vertical flow, it determines the maximum number of rows. Additional lanes are created as needed.
  • HorizontalSpacing and VerticalSpacing - specify the minimum horizontal and vertical gaps between table cells.
  • RowFillMode and ColFillMode - control how rows and columns fill the available height and width, respectively. Supported modes are None, Equal, Proportional, First, Last, and Justify. Justify distributes unused space by increasing the gaps between rows or columns.
  • RowFitMode and ColFitMode - control how rows and columns shrink when their combined size exceeds the available height or width, respectively. Supported modes are None, Equal, Proportional, First, and Last.

To experiment with the layout, change its properties in the property grid and click the Layout button.

Change MaxOrdinal to adjust the table structure, or change the drawing width and height to explore the filling and fitting behavior.


Table Flow Layout Example

C# Table Flow Layout Example Code for Nevron Diagram for WPF
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 - NTableFlowLayoutExample";

			// 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 Cells layout we provide the user with the ability to add shapes with different sizes so that he/she can test the layouts
			NButton addSmallItemButton = new NButton("Add Small Shape");
			addSmallItemButton.Click += OnAddSmallItemButtonClick;
			itemsStack.Add(addSmallItemButton);

			NButton addLargeItemButton = new NButton("Add Large Shape");
			addLargeItemButton.Click += OnAddLargeItemButtonClick;
			itemsStack.Add(addLargeItemButton);

			NButton addRandomItemButton = new NButton("Add Random Shape");
			addRandomItemButton.Click += OnAddRandomItemButtonClick;
			itemsStack.Add(addRandomItemButton);

			NButton removeAllItemsButton = new NButton("Remove All Shapes");
			removeAllItemsButton.Click += OnRemoveAllItemsButtonClick;
			itemsStack.Add(removeAllItemsButton);

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

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

The table flow layout arranges cells sequentially in a virtual table. Each lane contains a configurable maximum number of cells, with cells aligned across rows and columns.

The most important properties of this layout are:

  • Direction - determines the flow within each lane: LeftToRight, RightToLeft, TopToBottom, or BottomToTop.
  • Inverted - reverses the order in which lanes are arranged. The default value is false.
  • MaxOrdinal - specifies the maximum number of cells per lane. For horizontal flow, it determines the maximum number of columns. For vertical flow, it determines the maximum number of rows. Additional lanes are created as needed.
  • HorizontalSpacing and VerticalSpacing - specify the minimum horizontal and vertical gaps between table cells.
  • RowFillMode and ColFillMode - control how rows and columns fill the available height and width, respectively. Supported modes are None, Equal, Proportional, First, Last, and Justify. Justify distributes unused space by increasing the gaps between rows or columns.
  • RowFitMode and ColFitMode - control how rows and columns shrink when their combined size exceeds the available height or width, respectively. Supported modes are None, Equal, Proportional, First, and Last.

To experiment with the layout, change its properties in the property grid and click the Layout button.

Change MaxOrdinal to adjust the table structure, or change the drawing width and height to explore the filling and fitting behavior.

"; } /// /// Gets the relevant documentation links for the example /// /// public (string Name, string Url)[] GetDocumentationUrls() { return new[] { ("Table Flow Layout", "https://www.nevron.com/docs/openvision/table-flow-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"), ("Layouts Overview", "https://www.nevron.com/docs/openvision/layouts-overview.html"), }; } private void InitDiagram(NDrawingDocument drawingDocument) { m_Factory = new NBasicShapeFactory(); // Hide ports drawingDocument.Content.ScreenVisibility.ShowPorts = false; // Create some shapes NPage activePage = drawingDocument.Content.ActivePage; NBasicShapeFactory basicShapes = new NBasicShapeFactory(); const int range = 30; Random rnd = new Random(); for (int i = 0; i < 20; i++) { AddShape(rnd.Next(range) + range, rnd.Next(range) + range, false); } // Arrange diagram ArrangeDiagram(drawingDocument); // Fit page drawingDocument.Content.ActivePage.ZoomMode = ENZoomMode.Fit; } #endregion #region Implementation /// /// 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(); } private void OnAddSmallItemButtonClick(NEventArgs args) { AddShape(25, 25); } private void OnAddLargeItemButtonClick(NEventArgs args) { AddShape(60, 60); } private void OnAddRandomItemButtonClick(NEventArgs args) { int range = 30; Random rnd = new Random(); double width = rnd.Next(range) + range; double height = rnd.Next(range) + range; AddShape(width, height); } private void OnRemoveAllItemsButtonClick(NEventArgs args) { m_DrawingView.Document.StartHistoryTransaction("Remove All Items"); try { m_nCurShape = 1; m_DrawingView.Document.Content.ActivePage.Items.Clear(); } finally { m_DrawingView.Document.CommitHistoryTransaction(); } } private void AddShape(double width, double height, bool arrangeDiagram = true) { NShape shape = m_Factory.CreateShape(ENBasicShape.Rectangle); shape.Width = width; shape.Height = height; shape.HorizontalPlacement = ENHorizontalPlacement.Center; shape.VerticalPlacement = ENVerticalPlacement.Center; shape.Text = m_nCurShape.ToString(); m_nCurShape++; m_DrawingView.ActivePage.Items.Add(shape); if (arrangeDiagram) { ArrangeDiagram(m_DrawingView.Document); } } #endregion #region Event Handlers private void OnLayoutChanged(NEventArgs arg) { ArrangeDiagram(m_DrawingView.Document); } protected virtual void OnArrangeButtonClick(NEventArgs arg) { ArrangeDiagram(m_DrawingView.Document); } #endregion #region Fields private NDrawingView m_DrawingView; private NTableFlowLayout m_Layout = new NTableFlowLayout(ENHVDirection.LeftToRight); private NBasicShapeFactory m_Factory; private int m_nCurShape = 1; #endregion #region Static Methods #endregion #region Constants #endregion #region Nested Types #endregion } }

Download a fully functional C# (.cs) Table Flow Layout Example for WPF Solution

VB.NET Table Flow Layout Example Code for Nevron Diagram for WPF
Language: VB.NET

Imports Nevron.Nov
Imports Nevron.Nov.Diagram
Imports Nevron.Nov.Diagram.Layout
Imports Nevron.Nov.Diagram.Shapes
Imports Nevron.Nov.Dom
Imports Nevron.Nov.Editors
Imports Nevron.Nov.Graphics
Imports Nevron.Nov.Layout
Imports Nevron.Nov.UI
Imports Nevron.Nov.Windows.Wpf
Imports System

Class MainWindow

#Region "Constructors"

	Public Sub New()
		' This call is required by the designer.
		InitializeComponent()

		' Add any initialization after the InitializeComponent() call.

		' Set form title
		Title = "NOV WPF - NTableFlowLayoutExample"

		' Create the NOV example and its controls
		Dim exampleContent As NWidget = CreateExampleContent()
		Dim exampleControls As NWidget = CreateExampleControls()
		If Not exampleControls Is Nothing Then
			exampleControls.PreferredWidth = 300
		End If

		' Place the example and its controls in a pair box
		Dim pairBox As NPairBox = 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
		Dim host As NNovWidgetHost(Of NWidget) = New NNovWidgetHost(Of NWidget)(pairBox)
		Content = host
	End Sub


#End Region

#Region "Example"

        Public Function CreateExampleContent() As NWidget
            ' Create a simple drawing
            Dim drawingViewWithRibbon As NDrawingViewWithRibbon = New NDrawingViewWithRibbon()
            m_DrawingView = drawingViewWithRibbon.View

            m_DrawingView.Document.HistoryService.Pause()
            Try
                InitDiagram(m_DrawingView.Document)
            Finally
                m_DrawingView.Document.HistoryService.Resume()
            End Try

            Return drawingViewWithRibbon
        End Function
        Public Function CreateExampleControls() As NWidget
            Me.m_Layout.Changed += AddressOf OnLayoutChanged

            Dim stack As NStackPanel = New NStackPanel()

            ' property editor
            Dim editor As NEditor = NDesigner.GetDesigner(m_Layout).CreateStandaloneEditor(m_Layout)
            stack.Add(New NGroupBox("Properties", editor))

            Dim arrangeButton As NButton = New NButton("Arrange Diagram")
            arrangeButton.Click += AddressOf OnArrangeButtonClick
            stack.Add(arrangeButton)

            ' items stack
            Dim itemsStack As NStackPanel = New NStackPanel()

            ' NOTE: For Cells layout we provide the user with the ability to add shapes with different sizes so that he/she can test the layouts
            Dim addSmallItemButton As NButton = New NButton("Add Small Shape")
            addSmallItemButton.Click += AddressOf OnAddSmallItemButtonClick
            itemsStack.Add(addSmallItemButton)

            Dim addLargeItemButton As NButton = New NButton("Add Large Shape")
            addLargeItemButton.Click += AddressOf OnAddLargeItemButtonClick
            itemsStack.Add(addLargeItemButton)

            Dim addRandomItemButton As NButton = New NButton("Add Random Shape")
            addRandomItemButton.Click += AddressOf OnAddRandomItemButtonClick
            itemsStack.Add(addRandomItemButton)

            Dim removeAllItemsButton As NButton = New NButton("Remove All Shapes")
            removeAllItemsButton.Click += AddressOf OnRemoveAllItemsButtonClick
            itemsStack.Add(removeAllItemsButton)

            stack.Add(New NGroupBox("Items", itemsStack))

            Return stack
        End Function
        Public Function GetExampleDescription() As String
            Return "

The table flow layout arranges cells sequentially in a virtual table. Each lane contains a configurable maximum number of cells, with cells aligned across rows and columns.

The most important properties of this layout are:

  • Direction - determines the flow within each lane: LeftToRight, RightToLeft, TopToBottom, or BottomToTop.
  • Inverted - reverses the order in which lanes are arranged. The default value is false.
  • MaxOrdinal - specifies the maximum number of cells per lane. For horizontal flow, it determines the maximum number of columns. For vertical flow, it determines the maximum number of rows. Additional lanes are created as needed.
  • HorizontalSpacing and VerticalSpacing - specify the minimum horizontal and vertical gaps between table cells.
  • RowFillMode and ColFillMode - control how rows and columns fill the available height and width, respectively. Supported modes are None, Equal, Proportional, First, Last, and Justify. Justify distributes unused space by increasing the gaps between rows or columns.
  • RowFitMode and ColFitMode - control how rows and columns shrink when their combined size exceeds the available height or width, respectively. Supported modes are None, Equal, Proportional, First, and Last.

To experiment with the layout, change its properties in the property grid and click the Layout button.

Change MaxOrdinal to adjust the table structure, or change the drawing width and height to explore the filling and fitting behavior.

" End Function ''' ''' Gets the relevant documentation links for the example ''' ''' Public Function GetDocumentationUrls() As (String, String)() Return {("Table Flow Layout", "https://www.nevron.com/docs/openvision/table-flow-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"), ("Layouts Overview", "https://www.nevron.com/docs/openvision/layouts-overview.html")} End Function Private Sub InitDiagram(drawingDocument As NDrawingDocument) m_Factory = New NBasicShapeFactory() ' Hide ports drawingDocument.Content.ScreenVisibility.ShowPorts = False ' Create some shapes Dim activePage = drawingDocument.Content.ActivePage Dim basicShapes As NBasicShapeFactory = New NBasicShapeFactory() Const range = 30 Dim rnd As Random = New Random() For i = 0 To 19 AddShape(rnd.Next(range) + range, rnd.Next(range) + range, False) Next ' Arrange diagram ArrangeDiagram(drawingDocument) ' Fit page drawingDocument.Content.ActivePage.ZoomMode = ENZoomMode.Fit End Sub #End Region #Region "Implementation" ''' ''' Arranges the shapes in the active page. ''' ''' Private Sub ArrangeDiagram(drawingDocument As NDrawingDocument) ' get all top-level shapes that reside in the active page Dim activePage = drawingDocument.Content.ActivePage Dim shapes = activePage.GetShapes(False) ' create a layout context and use it to arrange the shapes using the current layout Dim layoutContext As NDrawingLayoutContext = New NDrawingLayoutContext(drawingDocument, activePage) m_Layout.Arrange(shapes.CastAll(Of Object)(), layoutContext) ' size the page to the content size activePage.SizeToContent() End Sub Private Sub OnAddSmallItemButtonClick(args As NEventArgs) AddShape(25, 25) End Sub Private Sub OnAddLargeItemButtonClick(args As NEventArgs) AddShape(60, 60) End Sub Private Sub OnAddRandomItemButtonClick(args As NEventArgs) Dim range = 30 Dim rnd As Random = New Random() Dim width As Double = rnd.Next(range) + range Dim height As Double = rnd.Next(range) + range AddShape(width, height) End Sub Private Sub OnRemoveAllItemsButtonClick(args As NEventArgs) m_DrawingView.Document.StartHistoryTransaction("Remove All Items") Try m_nCurShape = 1 m_DrawingView.Document.Content.ActivePage.Items.Clear() Finally m_DrawingView.Document.CommitHistoryTransaction() End Try End Sub Private Sub AddShape(width As Double, height As Double, Optional arrangeDiagram As Boolean = True) Dim shape = m_Factory.CreateShape(ENBasicShape.Rectangle) shape.Width = width shape.Height = height shape.HorizontalPlacement = ENHorizontalPlacement.Center shape.VerticalPlacement = ENVerticalPlacement.Center shape.Text = m_nCurShape.ToString() m_nCurShape += 1 m_DrawingView.ActivePage.Items.Add(shape) If arrangeDiagram Then Me.ArrangeDiagram(m_DrawingView.Document) End If End Sub #End Region #Region "Event Handlers" Private Sub OnLayoutChanged(arg As NEventArgs) ArrangeDiagram(m_DrawingView.Document) End Sub Protected Overridable Sub OnArrangeButtonClick(arg As NEventArgs) ArrangeDiagram(m_DrawingView.Document) End Sub #End Region #Region "Fields" Private m_DrawingView As NDrawingView Private m_Layout As NTableFlowLayout = New NTableFlowLayout(ENHVDirection.LeftToRight) Private m_Factory As NBasicShapeFactory Private m_nCurShape As Integer = 1 #End Region #Region "Static Methods" #End Region #Region "Constants" #End Region #Region "Nested Types" #End Region End Class

Download a fully functional VB.NET (.vb) Table Flow Layout Example for WPF Solution