DiagramControl.ItemDrawing Event
Fires repeatedly as the end-user is drawing a shape using a drawing tool (Rectangle, Ellipse, Right Triangle or Hexagon).
Namespace: DevExpress.Xpf.Diagram
Assembly: DevExpress.Xpf.Diagram.v24.1.dll
NuGet Package: DevExpress.Wpf.Diagram
Declaration
Event Data
The ItemDrawing event's data class is DiagramItemDrawingEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Cancel | Gets or sets whether the event should be canceled. Inherited from CancelRoutedEventArgs. |
| EndPosition | Specifies the current ending point of the drawing operation on the canvas. |
| 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 RoutedEventArgs. |
| Item | Returns the diagram item that is being drawn. |
| OriginalSource | Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs. |
| RoutedEvent | Gets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs. |
| Source | Gets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs. |
| Stage | Indicates whether the drawing operation has just started, is continuing or has been finished or canceled. |
| StartPosition | Indicates the point on the canvas where the end-user initiated the drawing operation by clicking and dragging with a drawing tool selected. |
| Tool | Returns the drawing tool that the end-user is using. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| InvokeEventHandler(Delegate, Object) | 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 RoutedEventArgs. |
| OnSetSource(Object) | 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 RoutedEventArgs. |
Remarks
The Tool property returns the drawing tool that the end-user is using. The Stage property indicates whether the drawing operation has just started, is continuing or has been finished or canceled. The StartPosition indicates the point on the canvas where the end-user initiated the drawing operation by clicking and dragging with a drawing tool selected. The EndPosition specifies the current ending point.