Windows フォームにおけるドラッグ アンド ドロップ機能
Windows フォームには、ドラッグ アンド ドロップ動作を実装するメソッド、イベント、およびクラスのセットが含まれます。 ここでは、Windows フォームにおけるドラッグ アンド ドロップ サポートの概要について説明します。 詳細については ドラッグ アンド ドロップ操作とクリップボードのサポート および ドラッグ アンド ドロップ操作とクリップボードのサポート および ドラッグ アンド ドロップ操作とクリップボードのサポート および ドラッグ アンド ドロップ操作とクリップボードのサポート.
ドラッグ アンド ドロップ操作の実行
ドラッグ アンド ドロップ操作を行うには、Control クラスの DoDragDrop メソッドを使用します。 ドラッグ アンド ドロップ操作の実行方法の詳細については、DoDragDrop のトピックを参照してください。 ドラッグ アンド ドロップ操作を開始する前に、マウス ポインターをドラッグする必要のある四角形の領域を取得するには、SystemInformation クラスの DragSize プロパティを使用します。
ドラッグ アンド ドロップ操作に関連するイベント
ドラッグ アンド ドロップ操作のイベントには 2 つのカテゴリがあります。つまり、ドラッグ アンド ドロップ操作の現在のターゲットで発生するイベントと、ドラッグ アンド ドロップ操作のソースで発生するイベントです。
現在のターゲットでのイベント
ドラッグ アンド ドロップ操作の現在のターゲットで発生するイベントを次の表に示します。
マウス イベント |
説明 |
|---|---|
このイベントは、オブジェクトがコントロールの境界内にドラッグされると発生します。 このイベントのハンドラーは、DragEventArgs 型の引数を受け取ります。 |
|
このイベントは、マウス ポインターがコントロールの境界内にあるときにオブジェクトがドラッグされると発生します。 このイベントのハンドラーは、DragEventArgs 型の引数を受け取ります。 |
|
このイベントは、ドラッグ アンド ドロップ操作が完了したときに発生します。 このイベントのハンドラーは、DragEventArgs 型の引数を受け取ります。 |
|
このイベントは、オブジェクトがコントロールの境界の外へドラッグされると発生します。 このイベントのハンドラーは、EventArgs 型の引数を受け取ります。 |
DragEventArgs クラスは、マウス ポインターの位置、マウス ボタンとキーボードの修飾子キーの現在の状態、ドラッグ対象のデータ、およびドラッグ イベントのソースによって許可される操作および操作のターゲットへのドロップの影響を指定する DragDropEffects 値を提供します。
ソースでのイベント
ドラッグ アンド ドロップ操作のソースで発生するイベントを次の表に示します。
マウス イベント |
説明 |
|---|---|
このイベントは、ドラッグ操作中に発生します。 ドラッグ アンド ドロップ操作が発生していることをユーザーが視覚的に確認できるようにします (マウス ポインターの変更など)。 このイベントのハンドラーは、GiveFeedbackEventArgs 型の引数を受け取ります。 |
|
このイベントは、ドラッグ アンド ドロップ操作中に発生し、ドラッグ アンド ドロップ操作をキャンセルするかどうかをドラッグ ソースが決定できるようにします。 このイベントのハンドラーは、QueryContinueDragEventArgs 型の引数を受け取ります。 |
QueryContinueDragEventArgs クラスは、マウス ボタンとキーボードの修飾子キーの現在の状態、Esc キーが押されたかどうかを指定する値、およびドラッグ アンド ドロップ操作を続行するかどうかを指定するために設定できる DragAction 値を提供します。