Windows フォームのドラッグ アンド ドロップ機能

Windows フォームには、ドラッグ アンド ドロップ動作を実装する一連のメソッド、イベント、およびクラスが含まれています。 このトピックでは、Windows フォームでのドラッグ アンド ドロップのサポートの概要について説明します。 「ドラッグ アンド ドロップ操作とクリップボードのサポート も参照してください。

ドラッグ アンド ドロップ操作の実行

ドラッグ アンド ドロップ操作を実行するには、Control クラスの DoDragDrop メソッドを使用します。 ドラッグ アンド ドロップ操作の実行方法の詳細については、「DoDragDrop」を参照してください。 ドラッグ アンド ドロップ操作を開始する前にマウス ポインターをドラッグする必要がある四角形を取得するには、SystemInformation クラスの DragSize プロパティを使用します。

ドラッグ アンド ドロップ操作に関連するイベント

ドラッグ アンド ドロップ操作には、ドラッグ アンド ドロップ操作の現在のターゲットで発生するイベントと、ドラッグ アンド ドロップ操作のソースで発生するイベントの 2 つのカテゴリがあります。

現在のターゲットのイベント

次の表は、ドラッグ アンド ドロップ操作の現在のターゲットで発生するイベントを示しています。

マウス イベント	説明
DragEnter	このイベントは、オブジェクトがコントロールの境界にドラッグされたときに発生します。 このイベントのハンドラーは、DragEventArgs型の引数を受け取ります。
DragOver	このイベントは、マウス ポインターがコントロールの境界内にある間にオブジェクトがドラッグされたときに発生します。 このイベントのハンドラーは、DragEventArgs型の引数を受け取ります。
DragDrop	このイベントは、ドラッグ アンド ドロップ操作が完了したときに発生します。 このイベントのハンドラーは、DragEventArgs型の引数を受け取ります。
DragLeave	このイベントは、オブジェクトがコントロールの境界からドラッグされたときに発生します。 このイベントのハンドラーは、EventArgs型の引数を受け取ります。

DragEventArgs クラスは、マウス ポインターの場所、マウス ボタンとキーボードの修飾キーの現在の状態、ドラッグされるデータ、およびドラッグ イベントのソースによって許可される操作と操作のターゲット ドロップ効果を指定する DragDropEffects 値を提供します。

ソースのイベント

次の表に、ドラッグ アンド ドロップ操作のソースで発生するイベントを示します。

マウス イベント	説明
GiveFeedback	このイベントは、ドラッグ操作中に発生します。 マウス ポインターの変更など、ドラッグ アンド ドロップ操作が発生していることを視覚的にユーザーに示す機会を提供します。 このイベントのハンドラーは、GiveFeedbackEventArgs型の引数を受け取ります。
QueryContinueDrag	このイベントは、ドラッグ アンド ドロップ操作中に発生し、ドラッグ ソースがドラッグ アンド ドロップ操作を取り消す必要があるかどうかを判断できるようにします。 このイベントのハンドラーは、QueryContinueDragEventArgs型の引数を受け取ります。

QueryContinueDragEventArgs クラスは、マウス ボタンとキーボードの修飾キーの現在の状態、ESC キーが押されたかどうかを指定する値、およびドラッグ アンド ドロップ操作を続行するかどうかを指定するために設定できる DragAction 値を提供します。

関連項目

• Windows フォーム アプリケーションでのマウス入力