WorkflowView.OnQueryContinueDrag(QueryContinueDragEventArgs) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ドラッグ操作中に発生し、ドラッグ 元がドラッグ オプションを取り消す必要があるかどうかを判断できるようにします。
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 列挙体を参照してください。
Note
OnDragOverイベントとOnGiveFeedback イベントはペアになっているため、マウスがドロップ ターゲットを越えて移動すると、ユーザーにはマウスの位置に関する up-to-date フィードバックが最も多く与えられます。
値が DragAction.Drop場合、ドロップ効果の値がソースに返されるため、ソース アプリケーションはソース データに対して適切な操作を実行できます。たとえば、操作が移動の場合はデータを切り取ります。
値が DragAction.Cancelの場合、 OnDragLeave イベントが発生します。
既定では、OnQueryContinueDragイベントは、esc キーが押された場合にActionにDragAction.Cancelを設定し、左、中央、または右のマウス ボタンが押された場合にActionをDragAction.Dropに設定します。