WorkflowView.OnQueryContinueDrag(QueryContinueDragEventArgs) メソッド

定義

名前空間:

System.Workflow.ComponentModel.Design

アセンブリ:

System.Workflow.ComponentModel.dll

ドラッグ アンド ドロップ操作中に発生し、ドラッグ ソースがドラッグ アンド ドロップ オプションをキャンセルする必要があるかどうかを決定できるようにします。

protected:
 override void OnQueryContinueDrag(System::Windows::Forms::QueryContinueDragEventArgs ^ qcdevent);

protected override void OnQueryContinueDrag (System.Windows.Forms.QueryContinueDragEventArgs qcdevent);

override this.OnQueryContinueDrag : System.Windows.Forms.QueryContinueDragEventArgs -> unit

Protected Overrides Sub OnQueryContinueDrag (qcdevent As QueryContinueDragEventArgs)

パラメーター

qcdevent

QueryContinueDragEventArgs

イベントに関する情報を格納している QueryContinueDragEventArgs。

注釈

OnQueryContinueDrag イベントは、ドラッグ操作中、キーボードまたはマウス ボタンの状態に変更があったときに発生します。 OnQueryContinueDrag イベントにより、ドラッグ ソースはドラッグ操作をキャンセルする必要があるかどうかを判断できます。

ドラッグ操作に関連するイベントは、当該コントロール上にドロップしてよい場合に発生します。 OnGiveFeedback イベントが発生する場合、ドラッグ効果を表す値が渡されます。 ドラッグ効果の一覧については、DragDropEffects 列挙体を参照してください。

マウス カーソルの位置、キーボードの状態、およびマウス ボタンの状態の変更が監視されます。

• ユーザーがウィンドウの外に移動した場合、OnDragLeave イベントが生成されます。

• マウスが別のコントロールに移動した場合は、そのコントロールの OnDragEnter が生成されます。

• マウスが移動しても同じコントロール内の場合は、OnDragOver イベントが生成されます。

キーボードまたはマウス ボタンの状態に変更があった場合、OnQueryContinueDrag イベントが生成され、このイベントの Action の QueryContinueDragEventArgs プロパティの値に応じて、ドラッグを継続するか、データをドロップするか、操作をキャンセルするかが判断されます。

値が DragAction.Continue の場合、操作を継続するための OnDragOver イベントが発生し、適切な視覚的フィードバックを設定できるように新しい効果が指定された OnGiveFeedback イベントが発生します。 有効なドロップ効果の一覧については、DragDropEffects 列挙体を参照してください。

注意

OnDragOver イベントおよび OnGiveFeedback イベントはペアになっています。したがって、マウスがドロップ ターゲットをまたがって移動した場合、マウスの位置に関する最新のフィードバックがユーザーに提示されます。

値が DragAction.Drop の場合は、ドロップ効果の値がソースに返されます。ソース アプリケーションでは、ソース データに対して適切な操作を実行できます。たとえば、移動操作だった場合は、データの切り取りなどを実行できます。

値が DragAction.Cancel の場合、OnDragLeave イベントが発生します。

既定では、Esc キーが押された場合、OnQueryContinueDrag イベントは Action を DragAction.Cancel に設定します。また、マウスの左右または中央のボタンが押された場合は Action を DragAction.Drop に設定します。