DiagramControl.ItemInitializing Event
In This Article
Fires each time an item is created via the DevExpress.Diagram.Core.ItemTool.
Namespace: DevExpress.Xpf.Diagram
Assembly: DevExpress.Xpf.Diagram.v24.2.dll
NuGet Package: DevExpress.Wpf.Diagram
#Declaration
public event EventHandler<DiagramItemInitializingEventArgs> ItemInitializing
#Event Data
The ItemInitializing event's data class is DiagramItemInitializingEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
Handled |
Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
Inherited from Routed |
Item | Returns the diagram item that is being initialized. |
Item |
Indicates whether the item is a part of the diagram or toolbox preview. |
Original |
Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.
Inherited from Routed |
Routed |
Gets or sets the Routed |
Source |
Gets or sets a reference to the object that raised the event.
Inherited from Routed |
The event data class exposes the following methods:
Method | Description |
---|---|
Invoke |
When overridden in a derived class, provides a way to invoke event handlers in a type-specific way, which can increase efficiency over the base implementation.
Inherited from Routed |
On |
When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.
Inherited from Routed |
#Remarks
The event parameter’s DiagramItemInitializingEventArgs.ItemUsage property indicates whether the item has been created in the diagram or toolbox preview.
See the example below.
private void diagram_ItemInitializing(object sender, DevExpress.Xpf.Diagram.DiagramItemInitializingEventArgs e) {
if ((e.Item is DevExpress.Xpf.Diagram.DiagramConnector)&&(e.ItemUsage == DevExpress.Diagram.Core.ItemUsage.Diagram)) {
(e.Item as DevExpress.Xpf.Diagram.DiagramConnector).Type = DevExpress.Diagram.Core.ConnectorType.Straight;
e.Item.ThemeStyleId = (e.Item as DevExpress.Xpf.Diagram.DiagramConnector).BeginItem.ThemeStyleId;
e.Item.StrokeId = (e.Item as DevExpress.Xpf.Diagram.DiagramConnector).BeginItem.ForegroundId;
e.Item.StrokeThickness = 2;
}
e.Handled = true;
}
See Also