ToolStripItem.DragLeave イベント

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ユーザーが項目をドラッグし、マウス ポインターがこの項目のクライアント領域上から離れたときに発生します。

public:
 event EventHandler ^ DragLeave;

[System.ComponentModel.Browsable(false)]
public event EventHandler? DragLeave;

[<System.ComponentModel.Browsable(false)>]
member this.DragLeave : EventHandler 

Public Custom Event DragLeave As EventHandler 

イベントの種類

EventHandler

属性

BrowsableAttribute

例

次のコード例では、このメンバーの使用方法を示します。 この例では、イベント ハンドラーがイベントの DragLeave 発生を報告します。 このレポートは、イベントが発生したタイミングを知るのに役立ち、デバッグに役立ちます。 複数のイベントまたは頻繁に発生するイベントを報告するには、 を Console.WriteLine に置き換えるかMessageBox.Show、複数行TextBoxにメッセージを追加することを検討してください。

コード例を実行するには、 や ToolStripMenuItemなどToolStripButton、 からToolStripItem継承する型のインスタンスを含むプロジェクトに貼り付けます。 次に、インスタンス ToolStripItem1 に名前を付け、イベント ハンドラーがイベントに DragLeave 関連付けられていることを確認します。

private void ToolStripItem1_DragLeave(Object sender, EventArgs e) {

   MessageBox.Show("You are in the ToolStripItem.DragLeave event.");
}

Private Sub ToolStripItem1_DragLeave(sender as Object, e as EventArgs) _ 
     Handles ToolStripItem1.DragLeave

   MessageBox.Show("You are in the ToolStripItem.DragLeave event.")

End Sub

注釈

イベントは DragLeave 、ユーザーがコントロールの外にカーソルをドラッグしたとき、またはユーザーが現在のドラッグ アンド ドロップ操作を取り消したときに発生します。

次の解説では、ドラッグ アンド ドロップ操作に関連するイベントが発生する方法とタイミングについて説明します。

メソッドは DoDragDrop 、現在のカーソル位置の下にある項目を決定します。 次に、項目が有効なドロップ ターゲットであるかどうかを確認します。

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

マウス カーソルの位置、キーボードの状態、およびマウス ボタンの状態の変更は、次の方法で追跡されます。

• ユーザーがウィンドウの外に移動した場合、DragLeave イベントが生成されます。

• マウスが別の項目に入ると、そのコントロールの が DragEnter 発生します。

• マウスが移動しても同じ項目内に留まる場合は DragOver 、イベントが発生します。

キーボードまたはマウス ボタンの状態が変更された場合、イベントが発生し、QueryContinueDragドラッグを続行するか、データをドロップするか、イベントQueryContinueDragEventArgsの の プロパティの値に基づいて操作をActionキャンセルするかを決定します。

の DragAction 値が Continueの場合、操作を DragOver 続行するためにイベントが発生し、 GiveFeedback 適切な視覚的フィードバックを設定できるように、新しい効果でイベントが発生します。 有効なドロップ効果の一覧については、DragDropEffects 列挙体を参照してください。

DragOverイベントと GiveFeedback イベントはペアになっているので、マウスがドロップ ターゲットを越えて移動すると、次のようにマウスの位置に関する最新のフィードバックがユーザーに与えられます。

• の DragAction 値が Dropの場合、ドロップ効果の値がソースに返されるため、ソース アプリケーションはソース データに対して適切な操作を実行できます。たとえば、操作が移動の場合はデータを切り取ります。

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