軟體套件 java.awt.dnd

Drag 和 Drop 是一種直接操作動作，在許多圖形使用者介面系統中都會遇到它，它提供了一種機制，能夠在兩個與 GUI 中顯示元素邏輯相關的實體之間傳輸資訊。

請參見：
描述

介面摘要

Autoscroll	在 DnD 操作期間，使用者有可能希望將操作目標放入一個可滾動的 GUI 控制元件區域中，而該區域當前對使用者是不可見的。
DragGestureListener	此介面源於 DragGestureRecognizer，當該（子）類別的物件檢測到拖動啟動動作時，調用此介面。
DragSourceListener	DragSourceListener 定義了事件介面，Drag 和 Drop 操作的始發端使用它來追蹤使用者操作的狀態，並通過 Drag 和 Drop 操作為使用者提供合適的“拖動結束”反饋。
DragSourceMotionListener	用於接收拖動操作期間鼠標移動事件的偵聽器介面。
DropTargetListener	DropTargetListener 介面是 DropTarget 類別所使用的回調介面，用於提供所涉及的 DropTarget 的 DnD 操作的通知。

類別摘要

DnDConstants	此類別包含了表示 Drag 和 Drop 操作所執行的操作型別的常數值。
DragGestureEvent	當特定的 DragGestureRecognizer 檢測到它正在追蹤的 Component 上已發生與平臺相關的拖動啟動動作時，將 DragGestureEvent 傳遞給 DragGestureListener 的 dragGestureRecognized() 方法。
DragGestureRecognizer	DragGestureRecognizer 是一個針對與平臺相關的偵聽器規範的抽象基礎類別，它可以與特定 Component 關聯以標識與平臺相關的拖動開始動作。
DragSource	DragSource 是負責開始 Drag 和 Drop 操作的實體，可以用在如下場景中： JVM 生命週期中每個 JVM 的一個預設實例。
DragSourceAdapter	用於接收拖動源事件的抽象適配器類別。
DragSourceContext	DragSourceContext 類別負責管理 Drag 和 Drop 協議的起始端。
DragSourceDragEvent	通過 DragSourceContext，將 DragSourceDragEvent 從 DragSourceContextPeer 傳遞給向 DragSourceContext 及其關聯 DragSource 註冊的 DragSourceListener。
DragSourceDropEvent	通過 DragSourceContext，將 DragSourceDropEvent 從 DragSourceContextPeer 傳遞給向 DragSourceContext 及其關聯 DragSource 註冊的 DragSourceListener 的 dragDropEnd 方法。
DragSourceEvent	此類別是 DragSourceDragEvent 和 DragSourceDropEvent 的基礎類別。
DropTarget	在 Drag 和 Drop 操作期間，當 Component 希望接受 drop 時，DropTarget 與 Component 有關聯。
DropTarget.DropTargetAutoScroller	此受保護的巢狀類別實作自動滾動
DropTargetAdapter	接收放置目標事件的抽象適配器類別。
DropTargetContext	每當與 Drag 和 Drop 操作相關的邏輯鼠標和與 DropTarget 相關的 Component 的可見幾何結構重合時，就創建一個 DropTargetContext。
DropTargetDragEvent	通過 dragEnter() 和 dragOver() 方法將 DropTargetDragEvent 發送給 DropTargetListener。
DropTargetDropEvent	通過 DropTargetListener drop() 方法發送 DropTargetDropEvent。
DropTargetEvent	DropTargetEvent 是 DropTargetDragEvent 和 DropTargetDropEvent 的基礎類別。
MouseDragGestureRecognizer	DragGestureRecognizer 的抽象子類別，它定義了一個基於鼠標動作的 DragGestureRecognizer。

異常摘要

InvalidDnDOperationException

java.awt.dnd 套件中的各種方法都會拋出此異常。

軟體套件 java.awt.dnd 的描述

Drag 和 Drop 是一種直接操作動作，在許多圖形使用者介面系統中都會遇到它，它提供了一種機制，能夠在兩個與 GUI 中顯示元素邏輯相關的實體之間傳輸資訊。Drag 和 Drop 通常由使用適當輸入設備的使用者的實際操作所驅動，它既提供在對 GUI 顯示元素導航期間啟用連續反饋（關於傳輸給使用者的任何後續資料的可能結果）的機制，又提供支持任何後續資料協商和傳輸的設施。

此套件定義了在 Java 中執行 Drag 和 Drop 操作所需的類別和介面。它定義了用於拖動源和放置目標的類別，以及用於傳輸正被拖動的資料的事件。此套件還在整個 Drag 和 Drop 操作期間提供一種向使用者提供可視反饋的方法。

典型的 Drag 和 Drop 操作可以分解為以下幾種狀態（未完全按順序）：

• 存在與 GUI 中某個顯示元素 (Component) 相關的 DragSource，以啟動對某個潛在 Transferable 資料的 Drag 和 Drop 操作。

• 進入/離開一個或多個與 GUI 中顯示元素（元件）相關的 DropTarget，很可能要使用 Transferable 資料型別。

• 為了追蹤和識別任何由使用者在 Component 上啟動的 Drag 操作，可以從 DragSource 獲取 DragGestureRecognizer，並讓它與一個 Component 相關聯。

• 使用者在 Component 上發起 Drag 操作，已註冊的 DragGestureRecognizer 檢測到該操作，並通知 DragGestureListener。

  註：儘管此 API 一直認為拖放操作是由使用者的實際操作觸發的，但這並不排除由適當的 DragSource 實作發出的以程式方式驅動的 DnD 操作。此套件包含用於識別鼠標設備操作的抽象類別 MouseDragGestureRecognizer。平臺可以提供其他抽象子類別，以支持其他輸入設備或特定的 Component 類別語義。

• DragGestureListener 使得 DragSource 按使用者的行為啟動 Drag 和 Drop 操作，或者啟動 GUI 鼠標，或呈現此操作主題項的 Image。

• 當使用者對 GUI 中帶相關 DropTarget 的 Component 進行定位時，根據受支持的操作和所涉及的資料型別，DragSource 接收通知以提供 "Drag Over" 反饋效果，而 "DropTarget" 接收通知以提供 "Drag Under" 反饋效果。

該操作本身可以在整個 GUI 層次結構中移動邏輯鼠標，交叉 GUI 元件的幾何形狀，並可能導致邏輯“Drag”鼠標進入、跨越、隨後離開 Component 及相關的 DropTarget。

DragSource 物件向使用者顯示“Drag Over”反饋，一般情況下是通過啟動與邏輯鼠標相關的 GUI Cursor 來實作的。

DropTarget 物件向使用者顯示“Drag Under”反饋，一般情況下是通過在 GUI Cursor 下將動畫呈現到相關 GUI Component 來實作的。

反饋結果的確認、資料轉換的最終成敗（只發生一種）是按如下方式參數化的：

• 由使用者選擇的傳輸“操作”，並受 DragSource 和 DropTarget 支持：複製、移動或參考（連接）。

• 通過 DragSource 所提供的資料型別集合和 DropTarget 可理解的資料型別集合的交集來實作。

• 當使用者終止 drag 操作時，一般會導致 Drop 操作成功，DragSource 和 DropTarget 都會接收到通知，該通知包含與 DragSource 相關的資訊，並且通過 Transferable 物件導致資訊的串流通和資訊型別的轉換。

從以下版本開始：

1.2