DiagramControl.AddingNewItem Event

Fires each time a new item is added to the diagram by the end-user (e.g., dropped from the toolbox, drawn using a tool).

Namespace: DevExpress.XtraDiagram

Assembly: DevExpress.XtraDiagram.v24.1.dll

NuGet Package: DevExpress.Win.Diagram

Declaration

C#

[DiagramCategory(DiagramCategory.DiagramItems)]
public event EventHandler<DiagramAddingNewItemEventArgs> AddingNewItem

VB.NET

<DiagramCategory(DiagramCategory.DiagramItems)>
Public Event AddingNewItem As EventHandler(Of DiagramAddingNewItemEventArgs)

Event Data

The AddingNewItem event's data class is DevExpress.XtraDiagram.DiagramAddingNewItemEventArgs.

Remarks

Set the event parameter’s DiagramAddingNewItemEventArgs.Cancel property to true to prevent adding an item to the diagram.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AddingNewItem event.

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#

winforms-diagram-track-and-restrict-drag-actions/CS/WinApp7/Form1.cs#L15

diagramControl1.AddingNewItem += DiagramControl1_AddingNewItem;
diagramControl1.BeforeItemsMoving += DiagramControl1_BeforeItemsMoving;