The stack layout is a directed constrained cells layout, which stacks the cells in horizontal or vertical order. Depending on the layout direction the layout is constrained by either width or height.
The most important properties of this layout are:
To experiment with their behavior just change the properties of the layout in the property grid and click the button Layout button.
Change the drawing width and height to see how the layout behaves with a different layout area.

| 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 - NStackLayoutExample";
// 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();
// layout area size -> controls either page width or height depending on layout direction
NGroupBox layoutAreaGroupBox = new NGroupBox("Layout Area Size");
stack.Add(layoutAreaGroupBox);
NSlider sizeSlider = CreateSlider(m_DrawingView.ActivePage.Width, 100, 1000, (args) =>
{
SetPageSize((double)args.NewValue);
});
layoutAreaGroupBox.Content = sizeSlider;
m_Layout.AddValueChangedEventHandler(NStackLayout.DirectionProperty, (args) =>
{
SetPageSize(sizeSlider.Value);
});
// 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 stack layout is a directed constrained cells layout, which stacks the cells in horizontal or vertical order.
Depending on the layout direction the layout is constrained by either width or height.
The most important properties of this layout are:
-
Direction - determines the direction in which the layout arranges adjacent cells.
-
HorizontalContentPlacement and VerticalContentPlacement - determine the default placement
of the cell content in regards to the X or the Y dimension of the cell bounds.
-
HorizontalSpacing and VerticalSpacing - determine the minimal spacing between 2 cells in
horizontal and vertical direction respectively.
-
FillMode - when the size of the content is smaller than the container size
the FillMode property is taken into account. Possible values are:
- None - no filling is performed
- Equal - all shapes are equally inflated
- Proportional - shapes are inflated proportionally to their size
- First - shapes are inflated in forward order until content fills the area
- Last - shapes are inflated in reverse order until content fills the area
In all cases the maximal size constraints of each shape are not broken.
-
FitMode - when the size of the content is larger than the container size
the FitMode property is taken into account. Possible values are:
- None - no fitting is performed
- Equal - all shapes are equally deflated
- Proportional - shapes are deflated proportionally to their size
- First - shapes are deflated in forward order until content fits the area
- Last - shapes are deflated in reverse order until content fits the area
In all cases the minimal size constraints of each shape are not broken.
To experiment with their behavior just change the properties of the layout in the property
grid and click the button Layout button.
Change the drawing width and height to see how the layout behaves with a different layout area.
";
}
///
/// Gets the relevant documentation links for the example
///
///
public (string Name, string Url)[] GetDocumentationUrls()
{
return new[]
{
("Stack Layout", "https://www.nevron.com/docs/openvision/stack-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();
for (int i = 0; i < 20; i++)
{
NShape shape = basicShapes.CreateShape(ENBasicShape.Rectangle);
activePage.Items.Add(shape);
}
// Arrange diagram
ArrangeDiagram(drawingDocument);
// Fit page
drawingDocument.Content.ActivePage.ZoomMode = ENZoomMode.Fit;
}
private NSlider CreateSlider(double value, double min, double max, DNFunction valueChanged)
{
NSlider slider = new NSlider(value, min, max);
slider.TicksPlacement = ENTicksPlacement.None;
slider.ValueChanged += valueChanged;
return slider;
}
private void SetPageSize(double size)
{
if (m_Layout.Direction == ENHVDirection.LeftToRight ||
m_Layout.Direction == ENHVDirection.RightToLeft)
{
m_DrawingView.ActivePage.Height = size;
}
else
{
m_DrawingView.ActivePage.Width = size;
}
ArrangeDiagram(m_DrawingView.Document);
}
#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