共用方式為


DragDrop 類別

定義

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

public ref class DragDrop abstract sealed
public static class DragDrop
type DragDrop = class
Public Class DragDrop
繼承
DragDrop

備註

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

注意

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

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

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

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

欄位

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

持續發生於拖放作業正在進行時,並可讓拖曳來源根據按鍵/按鈕狀態結束拖放作業。

適用於

另請參閱