Back to Devexpress

DiagramControl.ItemDrawing Event

wpf-devexpress-dot-xpf-dot-diagram-dot-diagramcontrol-25a05d37.md

latest5.4 KB
Original Source

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.v25.2.dll

NuGet Package : DevExpress.Wpf.Diagram

Declaration

csharp
public event EventHandler<DiagramItemDrawingEventArgs> ItemDrawing
vb
Public Event ItemDrawing As EventHandler(Of DiagramItemDrawingEventArgs)

Event Data

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

PropertyDescription
CancelGets or sets whether the event should be canceled. Inherited from CancelRoutedEventArgs.
EndPositionSpecifies the current ending point of the drawing operation on the canvas.
HandledGets 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.
ItemReturns the diagram item that is being drawn.
OriginalSourceGets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs.
RoutedEventGets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs.
SourceGets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs.
StageIndicates whether the drawing operation has just started, is continuing or has been finished or canceled.
StartPositionIndicates the point on the canvas where the end-user initiated the drawing operation by clicking and dragging with a drawing tool selected.
ToolReturns the drawing tool that the end-user is using.

The event data class exposes the following methods:

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

See Also

DiagramControl Class

DiagramControl Members

DevExpress.Xpf.Diagram Namespace