Control.DragEnter イベントとは? わかりやすく解説

Control.DragEnter イベント

オブジェクトがコントロールの境界内にドラッグされると発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文構文

Public Event DragEnter As
 DragEventHandler
Dim instance As Control
Dim handler As DragEventHandler

AddHandler instance.DragEnter, handler
public event DragEventHandler DragEnter
public:
event DragEventHandler^ DragEnter {
    void add (DragEventHandler^ value);
    void remove (DragEventHandler^ value);
}
/** @event */
public void add_DragEnter (DragEventHandler
 value)

/** @event */
public void remove_DragEnter (DragEventHandler
 value)
JScript では、イベントは使用できますが、新規に宣言することはできません。
解説解説

DragEnter イベントは、ユーザーがドラッグ アンド ドロップ操作中、最初にマウス カーソルをコントロール上にドラッグすると発生します。

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

DoDragDrop メソッドは、現在のカーソル位置に従ってコントロールを判別します。次に、コントロールが有効なドロップ ターゲットかどうかを確認します。

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

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

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

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例使用例

2 つの ListBox コントロールの間でドラッグ アンド ドロップ操作を実行するコード例を次に示します。この例では、ドラッグ アクションが開始したときに DoDragDrop メソッドが呼び出されます。ドラッグ操作は、MouseDown イベント実行中のマウス位置から SystemInformation.DragSize を超えてマウスが移動したときに開始されます。IndexFromPoint メソッドは、MouseDown イベントで、ドラッグする項目のインデックスを判別するために使用します。

この例では、ドラッグ アンド ドロップ操作でカスタム カーソルを使用する方法についても示します。この例では、2 つのカーソル ファイル (3dwarro.cur と 3dwno.cur) がアプリケーション ディレクトリ内に存在している必要があります。なお、それぞれのファイルはドラッグ用のカスタム カーソルとドロップなしのカスタム カーソルを表します。カスタム カーソルは、UseCustomCursorsCheckCheckBox がオンになっている場合に使用されます。カスタム カーソルは、GiveFeedback イベント ハンドラで設定されます。

キーボードの状態は、右側の ListBox の DragOver イベント ハンドラで評価されます。ドラッグ操作の内容は、Shift キー、Ctrl キー、Alt キー、または Ctrl + Alt キーの状態によって決まります。ドロップが発生する ListBox 内の位置は、DragOver イベント時にも判定されます。ドロップするデータが String でない場合は、DragEventArgs.Effect が DragDropEffects で None に設定されます。最後に、ドロップのステータスが DropLocationLabelLabel に表示されます。

右側の ListBox にドロップするデータは、DragDrop イベント ハンドラで判定されます。また、String 値が ListBox の該当する場所に追加されます。ドラッグ操作がフォームの範囲を超えて移動した場合、ドラッグ アンド ドロップ操作は QueryContinueDrag イベント ハンドラでキャンセルされます。

DragEnter イベントの使用方法を次のコード例に示します。コード例全体については、DoDragDrop メソッドのトピックを参照してください。

Private Sub ListDragTarget_DragEnter(ByVal
 sender As Object, ByVal
 e As DragEventArgs) Handles ListDragTarget.DragEnter

    ' Reset the label text.
    DropLocationLabel.Text = "None"
End Sub
private void ListDragTarget_DragEnter(object
 sender, System.Windows.Forms.DragEventArgs e) {
    // Reset the label text.
    DropLocationLabel.Text = "None";
}
void ListDragTarget_DragEnter( Object^ /*sender*/, System::Windows::Forms::DragEventArgs^
 /*e*/ )
{
   // Reset the label text.
   DropLocationLabel->Text = "None";
}
private void listDragTarget_DragEnter(Object
 sender, 
    System.Windows.Forms.DragEventArgs e)
{
    // Reset the label text.
    dropLocationLabel.set_Text("None");
} //listDragTarget_DragEnter
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「Control.DragEnter イベント」の関連用語

Control.DragEnter イベントのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



Control.DragEnter イベントのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS