This documentation is archived and is not being maintained.

WorkflowView.OnQueryContinueDrag Method

Occurs during a drag operation and allows the drag source to determine whether the drag option should be canceled.

Namespace: System.Workflow.ComponentModel.Design
Assembly: System.Workflow.ComponentModel (in system.workflow.componentmodel.dll)

protected override void OnQueryContinueDrag (
	QueryContinueDragEventArgs qcdevent
)
protected void OnQueryContinueDrag (
	QueryContinueDragEventArgs qcdevent
)
protected override function OnQueryContinueDrag (
	qcdevent : QueryContinueDragEventArgs
)
Not applicable.

Parameters

qcdevent

A QueryContinueDragEventArgs that contains information about the event.

The OnQueryContinueDrag event is raised when there is a change in the keyboard or mouse button state during a drag operation. The OnQueryContinueDrag event allows the drag source to determine whether the drag operation should be canceled.

Events related to drag operations are raised when the control is a valid drop target. The OnGiveFeedback event is raised with the drag effect specified. For a list of drag effects, see the DragDropEffects enumeration.

Changes in the mouse cursor position, keyboard state, and mouse button state are tracked.

  • If the user moves out of a window, the OnDragLeave event is raised.

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

  • If the mouse moves but stays within the same control, 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.

NoteNote:

The OnDragOver and OnGiveFeedback events are paired so that as the mouse moves across the drop target, the user is given 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 the source application can perform the appropriate operation on the source data; for example, cut the data if the operation was a move.

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

By default, the OnQueryContinueDrag event sets Action to DragAction.Cancel if the ESC key was pressed and sets Action to DragAction.Drop if the left, middle, or right mouse button is pressed.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Show: