DiagramControl.Items Property

Provides access to the collection of diagram items displayed by the DiagramControl.

Namespace: DevExpress.XtraDiagram

Assembly: DevExpress.XtraDiagram.v24.1.dll

NuGet Package: DevExpress.Win.Diagram

Declaration

C#

[Browsable(false)]
public DiagramItemCollection Items { get; }

VB.NET

<Browsable(False)>
Public ReadOnly Property Items As DiagramItemCollection

Property Value

Type	Description
DiagramItemCollection	The collection of diagram items.

Remarks

DiagramItem objects must be added to the Items collection to be displayed in the DiagramControl.

Diagram shapes (DiagramShape) are positioned on the diagram canvas with the DiagramItem.Position property. You can specify a diagram shape’s position and size in the object’s constructor. For information on DiagramConnector positioning, see this class description.

The DevExpress.Diagram.Core.Native.DiagramExtensionsCore.Connectors extension method returns the collection of Connectors contained in the diagram. Using this method is more efficient than iterating through the Items collection.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Items property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-a-diagramshape-descendant-and-serialize-its-properties-t361265/CS/XtraDiagram.CustomShapeProperties/Form1.cs#L47

diagramControl1.LoadDocument(diagramName);
foreach (var item in diagramControl1.Items) {
    var shape = item as DiagramShapeEx;

winforms-diagram-proportionally-resize-shapes-within-container/CS/WindowsFormsApp4/Form1.cs#L27

    base.OnLoad(e);
    diagramControl1.FitToItems(diagramControl1.Items);
}

winforms-diagram-create-rotatable-containers-with-shapes/CS/WindowsFormsApp4/Form1.cs#L52

    base.OnLoad(e);
    diagramControl1.FitToItems(diagramControl1.Items);
}

VB.NET

how-to-create-a-diagramshape-descendant-and-serialize-its-properties-t361265/VB/XtraDiagram.CustomShapeProperties/Form1.vb#L49

diagramControl1.LoadDocument(diagramName)
For Each item In diagramControl1.Items
    Dim shape = TryCast(item, DiagramShapeEx)

winforms-diagram-proportionally-resize-shapes-within-container/VB/WindowsFormsApp4/Form1.vb#L27

    MyBase.OnLoad(e)
    diagramControl1.FitToItems(diagramControl1.Items)
End Sub

winforms-diagram-create-rotatable-containers-with-shapes/VB/WindowsFormsApp4/Form1.vb#L56

    MyBase.OnLoad(e)
    diagramControl1.FitToItems(diagramControl1.Items)
End Sub