Edit

ActivityDesigner.OnDragEnter(ActivityDragEventArgs) Method

  • Reference

Definition

Namespace:
System.Workflow.ComponentModel.Design
Assembly:
System.Workflow.ComponentModel.dll

Occurs when the drag-drop operation is in progress and the pointer enters the designer bounds.

protected:
 virtual void OnDragEnter(System::Workflow::ComponentModel::Design::ActivityDragEventArgs ^ e);
protected virtual void OnDragEnter (System.Workflow.ComponentModel.Design.ActivityDragEventArgs e);
abstract member OnDragEnter : System.Workflow.ComponentModel.Design.ActivityDragEventArgs -> unit
override this.OnDragEnter : System.Workflow.ComponentModel.Design.ActivityDragEventArgs -> unit
Protected Overridable Sub OnDragEnter (e As ActivityDragEventArgs)

Parameters

e
ActivityDragEventArgs

An ActivityDragEventArgs that contains the event data.

Remarks

The OnDragEnter event is raised when the mouse is dragged into the designer.

The following describes how and when events related to drag-and-drop operations are raised.

If the designer is a valid drop target, the OnGiveFeedback event is raised with the drag-and-drop effect specified. For a list of drag-and-drop effects, see the DragDropEffects enumeration.

Changes in the pointer position, keyboard state, and mouse comment state are tracked.

  • If the user moves out of the designer bounds, the OnDragLeave event is raised.

  • If the mouse enters another designer, the OnDragEnter for that designer is raised.

  • If the mouse moves but stays within the same designer, the OnDragOver event is raised.

  • If there is a change in the keyboard or mouse button state, the OnQueryContinueDrag event is raised and determines whether to continue the drag, to drop the data, or to cancel the operation based on the value of the Action property of the event QueryContinueDragEventArgs.

If the value is DragAction.Continue, the OnDragOver event is raised to continue the operation and the OnGiveFeedback event is raised with the new effect so appropriate visual feedback can be set. For a list of valid drop effects, see the DragDropEffects enumeration.

Note

The OnDragOver and OnGiveFeedback events are paired so that as the mouse moves across the drop target, the user is supplied with the most up to date feedback on the mouse position.

If the value is DragAction.Drop, the drop effect value is returned to the source, so that the source application can perform the appropriate operation on the source data; for example, see comment the data if the operation was a move.

If the value is DragAction.Cancel, the OnDragLeave event is raised.

For more information about how to handle events, see Handling and Raising Events.

Applies to