DragDrop 類別

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

提供用以啟始拖放作業的 Helper 方法與欄位，包括開始拖放作業的方法，以及用以加入及移除拖放相關事件處理常式的機能。

public ref class DragDrop abstract sealed

public static class DragDrop

type DragDrop = class

Public Class DragDrop

繼承

Object

DragDrop

備註

拖放通常是指資料傳輸的方法，包括使用滑鼠 (或其他指向裝置) 來選取一或多個物件、將這些物件拖曳到使用者介面 (UI) 的一些所需置放目標上，然後卸載它們。 拖放作業類似于複製 (或剪下) 貼上作業，用來將資料從某個物件或應用程式傳輸到另一個物件。 拖放作業通常涉及兩方：拖曳資料的來源，以及接收已卸載資料的置放目標。 拖放作業所需的事件和方法會在 DragDrop 類別中定義。 拖放事件是可附加至任何 UIElement 或 ContentElement 的附加事件。 拖放目標可能是相同應用程式或不同應用程式中的 UI 元素。 不過，置放目標必須知道如何處理拖曳來源所傳遞的資料。

注意

UIElement和 ContentElement 類別包含拖放事件的別名，因此當這些類別繼承為基類時，事件會出現在類別成員清單中。 當您將事件處理常式附加至這些類別的其中一個拖放事件時，處理常式會附加至基礎 DragDrop 事件，並接收相同的事件資料實例。 如需範例，請參閱 UIElement.Drop。

拖曳來源會呼叫靜態 DoDragDrop 方法，並將所傳送的資料傳遞給該方法，來啟始拖放作業。 元素通常會在拖曳來源時處理下列事件：

• GiveFeedback

• QueryContinueDrag

元素通常會在卸載目標時處理下列事件：

• DragEnter

• DragLeave

• DragOver

• Drop

如需詳細資訊和範例，請參閱 拖放概觀。

欄位

DragEnterEvent	識別 DragEnter 附加事件。
DragLeaveEvent	識別 DragLeave 附加事件。
DragOverEvent	識別 DragOver 附加事件。
DropEvent	識別 Drop 附加事件。
GiveFeedbackEvent	識別 GiveFeedback 附加事件。
PreviewDragEnterEvent	識別 PreviewDragEnter 附加事件。
PreviewDragLeaveEvent	識別 PreviewDragLeave 附加事件。
PreviewDragOverEvent	識別 PreviewDragOver 附加事件。
PreviewDropEvent	識別 PreviewDrop 附加事件。
PreviewGiveFeedbackEvent	識別 PreviewGiveFeedback 附加事件。
PreviewQueryContinueDragEvent	識別 PreviewQueryContinueDrag 附加事件。
QueryContinueDragEvent	識別 QueryContinueDrag 附加事件。

方法

AddDragEnterHandler(DependencyObject, DragEventHandler)	將 DragEnter 事件處理常式加入指定的相依性物件中。
AddDragLeaveHandler(DependencyObject, DragEventHandler)	將 DragLeave 事件處理常式加入指定的相依性物件中。
AddDragOverHandler(DependencyObject, DragEventHandler)	將 DragOver 事件處理常式加入指定的相依性物件中。
AddDropHandler(DependencyObject, DragEventHandler)	將 Drop 事件處理常式加入指定的相依性物件中。
AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	將 GiveFeedback 事件處理常式加入指定的相依性物件中。
AddPreviewDragEnterHandler(DependencyObject, DragEventHandler)	將 PreviewDragEnter 事件處理常式加入指定的相依性物件中。
AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler)	將 PreviewDragLeave 事件處理常式加入指定的相依性物件中。
AddPreviewDragOverHandler(DependencyObject, DragEventHandler)	將 PreviewDragOver 事件處理常式加入指定的相依性物件中。
AddPreviewDropHandler(DependencyObject, DragEventHandler)	將 PreviewDrop 事件處理常式加入指定的相依性物件中。
AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	將 PreviewGiveFeedback 事件處理常式加入指定的相依性物件中。
AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	將 PreviewQueryContinueDrag 事件處理常式加入指定的相依性物件中。
AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	將 QueryContinueDrag 事件處理常式加入指定的相依性物件中。
DoDragDrop(DependencyObject, Object, DragDropEffects)	啟始拖放作業。
RemoveDragEnterHandler(DependencyObject, DragEventHandler)	從所指定相依性物件中移除 DragEnter 事件處理常式。
RemoveDragLeaveHandler(DependencyObject, DragEventHandler)	從所指定相依性物件中移除 DragLeave 事件處理常式。
RemoveDragOverHandler(DependencyObject, DragEventHandler)	從所指定相依性物件中移除 DragOver 事件處理常式。
RemoveDropHandler(DependencyObject, DragEventHandler)	從所指定相依性物件中移除 Drop 事件處理常式。
RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	從所指定相依性物件中移除 GiveFeedback 事件處理常式。
RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler)	從所指定相依性物件中移除 PreviewDragEnter 事件處理常式。
RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler)	從所指定相依性物件中移除 PreviewDragLeave 事件處理常式。
RemovePreviewDragOverHandler(DependencyObject, DragEventHandler)	從所指定相依性物件中移除 PreviewDragOver 事件處理常式。
RemovePreviewDropHandler(DependencyObject, DragEventHandler)	從所指定相依性物件中移除 PreviewDrop 事件處理常式。
RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	從所指定相依性物件中移除 PreviewGiveFeedback 事件處理常式。
RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	從所指定相依性物件中移除 PreviewQueryContinueDrag 事件處理常式。
RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	從所指定相依性物件中移除 QueryContinueDrag 事件處理常式。

附加事件

DragEnter	在置放目標項目的界限內拖曳物件時發生。
DragLeave	從置放目標項目的界限拖曳出物件但不置放時發生。
DragOver	在置放目標項目的界限內拖曳物件時持續發生。
Drop	在置放目標項目的界限內置放物件時發生。
GiveFeedback	拖放作業正在進行時持續發生，並可讓拖曳來源提供意見反應給使用者。
PreviewDragEnter	在置放目標項目的界限內拖曳物件時發生。
PreviewDragLeave	從置放目標項目的界限拖曳出物件但不置放時發生。
PreviewDragOver	在置放目標項目的界限內拖曳物件時持續發生。
PreviewDrop	在置放目標項目的界限內置放物件時發生。
PreviewGiveFeedback	拖放作業正在進行時持續發生，並可讓拖曳來源提供意見反應給使用者。
PreviewQueryContinueDrag	持續發生於拖放作業正在進行時，並可讓拖曳來源根據按鍵/按鈕狀態結束拖放作業。
QueryContinueDrag	持續發生於拖放作業正在進行時，並可讓拖曳來源根據按鍵/按鈕狀態結束拖放作業。

另請參閱

• DataObject