Back to Devexpress

DiagramControl.Items Property

windowsforms-devexpress-dot-xtradiagram-dot-diagramcontrol.md

latest5.1 KB
Original Source

DiagramControl.Items Property

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

Namespace : DevExpress.XtraDiagram

Assembly : DevExpress.XtraDiagram.v25.2.dll

NuGet Package : DevExpress.Win.Diagram

Declaration

csharp
[Browsable(false)]
public DiagramItemCollection Items { get; }
vb
<Browsable(False)>
Public ReadOnly Property Items As DiagramItemCollection

Property Value

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

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.

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

csharp
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

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

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

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

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

vb
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

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

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

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

See Also

ItemsChanged

DiagramControl Class

DiagramControl Members

DevExpress.XtraDiagram Namespace