ActivityDesigner.OnDragLeave メソッド

定義

ドラッグ ドロップの操作中にマウス ポインターがデザイナーの境界から出ると発生します。

protected:
 virtual void OnDragLeave();
protected virtual void OnDragLeave ();
abstract member OnDragLeave : unit -> unit
override this.OnDragLeave : unit -> unit
Protected Overridable Sub OnDragLeave ()

注釈

OnDragLeave イベントは、ユーザーがマウス ポインターをデザイナーの外にドラッグするか、現在のドラッグ アンド ドロップ操作をキャンセルすると発生します。

ドラッグ アンド ドロップ操作関連のイベントがどのように、いつ発生するかについて次に示します。

デザイナーが有効なドロップ ターゲットの場合、ドラッグ アンド ドロップの効果が指定された OnGiveFeedback イベントが発生します。 ドラッグ アンド ドロップ効果の一覧については、DragDropEffects 列挙体を参照してください。

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

  • マウスをデザイナー境界の外側に移動した場合は、OnDragLeave イベントが発生します。

  • マウスを別のデザイナーに移動した場合は、そのデザイナーの OnDragEnter イベントが発生します。

  • マウスを同じデザイナー内で移動した場合は、OnDragOver イベントが発生します。

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

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

注意

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

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

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

イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。

適用対象