ActivityDesigner.OnDragEnter(ActivityDragEventArgs) メソッド

定義

名前空間:

System.Workflow.ComponentModel.Design

アセンブリ:

System.Workflow.ComponentModel.dll

ドラッグ ドロップの操作中にポインターがデザイナーの境界内に入ると発生します。

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)

パラメーター

e

ActivityDragEventArgs

イベント データを格納している ActivityDragEventArgs。

注釈

OnDragEnter イベントは、マウスがデザイナー内にドラッグされると発生します。

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

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

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

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

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

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

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

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

注意

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

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

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

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