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 。 此報告可協助您瞭解事件發生的時間，並可協助您進行偵錯。 若要報告多個事件或經常發生的事件，請考慮將 取代 MessageBox.Show 為 Console.WriteLine 或將訊息附加至多行 TextBox 。

若要執行範例程式碼，請將它貼入包含繼承自 ToolStripItem 之型別實例的專案，例如 ToolStripButton 或 ToolStripMenuItem 。 然後命名 實例 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 則會引發 事件，並判斷是否要繼續拖曳、卸載資料，或根據 Action 事件的 QueryContinueDragEventArgs 屬性值取消作業。

如果 的值為 DragActionContinue ，則會 DragOver 引發 事件以繼續作業，並以 GiveFeedback 新的效果引發 事件，以便設定適當的視覺回饋。 如需有效置放效果的清單，請參閱 DragDropEffects 列舉型別。

和 DragOverGiveFeedback 事件會配對，如此一來，當滑鼠在置放目標上移動時，系統會提供使用者對滑鼠位置的最新意見反應，如下所示：

• 如果 的值為 DragActionDrop ，則會將置放效果值傳回至來源，讓來源應用程式可以在來源資料上執行適當的作業;例如，如果作業是移動，請剪下資料。

• 如果 的 DragActionCancel 值為 ，則會 DragLeave 引發 事件。