DiagramControl.ItemCreating Event

Occurs when the DiagramControl creates a diagram item.

Namespace: DevExpress.XtraDiagram

Assembly: DevExpress.XtraDiagram.v24.1.dll

NuGet Package: DevExpress.Win.Diagram

Declaration

C#

[DiagramCategory(DiagramCategory.DiagramItems)]
public event EventHandler<DiagramItemCreatingEventArgs> ItemCreating

VB.NET

<DiagramCategory(DiagramCategory.DiagramItems)>
Public Event ItemCreating As EventHandler(Of DiagramItemCreatingEventArgs)

Event Data

The ItemCreating event's data class is DiagramItemCreatingEventArgs. The following properties provide information specific to this event:

Property	Description
Item	Gets or sets the item that is about to be created.
ItemType	Gets the type of the item that is about to be created.
ItemUsage	Indicates whether the item is a part of the diagram or toolbox preview.

Remarks

You can use the ItemCreating event to create custom items. The following code snippet illustrates how to use the event to substitute regular shapes with custom DiagramShapeEx shapes.

C#

private void DiagramControl1_ItemCreating(object sender, DevExpress.XtraDiagram.DiagramItemCreatingEventArgs e) {
    if (e.ItemType == typeof(DiagramShape)) {
        e.Item = new DiagramShapeEx();
    }
}

VB.NET

Private Sub DiagramControl1_ItemCreating(ByVal sender As Object, ByVal e As DevExpress.XtraDiagram.DiagramItemCreatingEventArgs)
    If e.ItemType Is GetType(DiagramShape) Then
        e.Item = New DiagramShapeEx()
    End If
End Sub

Tip

Register custom item types at the application start using the DiagramItemTypeRegistrator.Register method to enable their deserialization.

C#

DiagramControl.ItemTypeRegistrator.Register(typeof(DiagramShapeEx));

VB.NET

DiagramControl.ItemTypeRegistrator.Register(GetType(DiagramShapeEx))