ActivityDesigner.OnDragEnter(ActivityDragEventArgs) メソッド

定義

ドラッグ ドロップ操作が進行中で、ポインターがデザイナーの境界に入ったときに発生します。

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 列挙体を参照してください。

Note

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

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

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

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

適用対象