Control.DragEnter イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オブジェクトがコントロールの境界にドラッグされたときに発生します。
public:
event System::Windows::Forms::DragEventHandler ^ DragEnter;
public event System.Windows.Forms.DragEventHandler DragEnter;
public event System.Windows.Forms.DragEventHandler? DragEnter;
member this.DragEnter : System.Windows.Forms.DragEventHandler
Public Custom Event DragEnter As DragEventHandler
イベントの種類
例
次のコード例は、2 つの ListBox コントロール間のドラッグ アンド ドロップ操作を示しています。 この例では、ドラッグ アクションの開始時に DoDragDrop メソッドを呼び出します。 ドラッグ 操作は、MouseDown イベント中にマウスの位置からマウスが SystemInformation.DragSize 以上移動した場合に開始されます。
IndexFromPoint メソッドは、MouseDown
イベント中にドラッグする項目のインデックスを決定するために使用されます。
この例では、ドラッグ アンド ドロップ操作にカスタム カーソルを使用する方法も示します。 この例では、カスタム ドラッグ カーソルとドロップなしのカーソルに対して、それぞれ 2 つのカーソル ファイル (3dwarro.cur
と 3dwno.cur
) がアプリケーション ディレクトリに存在している必要があります。
UseCustomCursorsCheck
CheckBox がチェックされている場合は、カスタム カーソルが使用されます。 カスタム カーソルは、GiveFeedback イベント ハンドラーで設定されます。
キーボードの状態は、右 ListBox
の DragOver イベント ハンドラーで評価され、Shift キー、Ctrl キー、Alt キー、または Ctrl + Alt キーの状態に基づいてドラッグ操作を決定します。 ドロップが発生する ListBox
内の場所も、DragOver
イベント中に決定されます。 削除するデータが String
でない場合、DragEventArgs.Effect は DragDropEffectsで None
に設定されます。 最後に、ドロップの状態が DropLocationLabel
Labelに表示されます。
適切な ListBox
に対して削除するデータは、DragDrop イベント ハンドラーで決定され、String
値は ListBox
の適切な場所に追加されます。 ドラッグ操作がフォームの境界外に移動すると、QueryContinueDrag イベント ハンドラーでドラッグ アンド ドロップ操作が取り消されます。
このコードの抜粋は、DragEnter イベントの使用方法を示しています。 完全なコード例については、DoDragDrop メソッドを参照してください。
void ListDragTarget_DragEnter( Object^ /*sender*/, System::Windows::Forms::DragEventArgs^ /*e*/ )
{
// Reset the label text.
DropLocationLabel->Text = "None";
}
private void ListDragTarget_DragEnter(object sender, DragEventArgs e)
{
// Reset the label text.
DropLocationLabel.Text = "None";
}
Private Sub ListDragTarget_DragEnter(ByVal sender As Object, ByVal e As DragEventArgs) Handles ListDragTarget.DragEnter
' Reset the label text.
DropLocationLabel.Text = "None"
End Sub
注釈
DragEnter イベントは、ドラッグ アンド ドロップ操作中にユーザーが最初にマウス カーソルをコントロールの上にドラッグしたときに発生します。
手記
.NET Framework 2.0 より前のバージョンでは、DragEnter イベントと DragDrop イベントを含む UserControl を Windows フォームに配置し、デザイン時に何かを UserControl にドラッグ アンド ドロップすると、DropDrop
イベントと DropEnter
イベントが発生します。 ただし、ソリューションを閉じて再度開くと、DragEnter イベントと DragDrop イベントは再び発生しません。
ドラッグ アンド ドロップ操作に関連するイベントが発生する方法とタイミングを次に示します。
DoDragDrop メソッドは、現在のカーソル位置のコントロールを決定します。 次に、コントロールが有効なドロップ ターゲットであるかどうかを確認します。
コントロールが有効なドロップ ターゲットの場合、ドラッグ アンド ドロップ効果が指定された状態で GiveFeedback イベントが発生します。 ドラッグ アンド ドロップ効果の一覧については、DragDropEffects 列挙型を参照してください。
マウス カーソルの位置、キーボードの状態、およびマウス ボタンの状態の変更が追跡されます。
ユーザーがウィンドウの外に移動すると、DragLeave イベントが発生します。
マウスが別のコントロールに入ると、そのコントロールの DragEnter が発生します。
マウスが移動しても同じコントロール内に留まった場合、DragOver イベントが発生します。
キーボードまたはマウス ボタンの状態が変化した場合、QueryContinueDrag イベントが発生し、ドラッグを続行するか、データをドロップするか、イベントの QueryContinueDragEventArgsの Action プロパティの値に基づいて操作をキャンセルするかを決定します。
DragAction の値が
Continue
場合、操作を続行するために DragOver イベントが発生し、適切な視覚的フィードバックを設定できるように、GiveFeedback イベントが新しい効果で発生します。 有効なドロップ効果の一覧については、DragDropEffects 列挙型を参照してください。手記
DragOver イベントと GiveFeedback イベントはペアになっているため、マウスがドロップ ターゲットを越えて移動すると、ユーザーはマウスの位置に対して最も up-to-date フィードバックを受け取ります。
DragAction の値が
Drop
場合、ドロップ効果の値がソースに返されるため、ソース アプリケーションはソース データに対して適切な操作を実行できます。たとえば、操作が移動の場合はデータを切り取ります。DragAction の値が
Cancel
場合、DragLeave イベントが発生します。手記
DragEventArgs の X プロパティと Y プロパティは、クライアント座標ではなく画面座標にあります。 次の Visual C# コード行は、プロパティをクライアント Pointに変換します。
Point clientPoint = targetControl.PointToClient(new Point(de.X, de.Y));
イベントの処理の詳細については、「イベントの処理と発生」を参照してください。
適用対象
こちらもご覧ください
.NET