java.awt.dnd
類別 DropTargetAdapter

java.lang.Object
  java.awt.dnd.DropTargetAdapter

所有已實作的介面：

DropTargetListener, EventListener

public abstract class DropTargetAdapter
extends Object
implements DropTargetListener

接收放置目標事件的抽象適配器類別。此類別中的方法為空。此類別存在的目的只是為了便於創建偵聽器物件。

擴展此類別即可創建 DropTargetEvent 偵聽器並為感興趣的事件覆寫該方法。（如果實作了 DropTargetListener 介面，則必須定義該介面內的所有方法。此抽象類別為除 drop(DropTargetDropEvent) 以外的所有方法都定義了 null 實作，所以只需為關心的事件定義方法即可。）使用者必須至少為 drop(DropTargetDropEvent) 提供一個實作。因為此方法的規範要求接受或拒絕放置，並且如果接受的話，要指出放置是否成功，所以此方法不能是 null 實作。

使用擴展的類別創建偵聽器物件，然後向 DropTarget 註冊它。當拖動進入、移動或離開該 DropTarget 放置點的可操作部分時，以及放置操作改變時和放置發生時，調用該偵聽器物件中的相關方法，並將 DropTargetEvent 傳遞給它。

DropTarget 放置點的可操作部分是關聯 Component 的幾何形狀的一部分，該部分未被頂層視窗或另一個與活動 DropTarget 關聯並且在 Z-order（排順）中更高的 Component 所覆寫。

在拖動期間，可檢索與當前拖動操作相關聯的資料，方法是調用傳遞給偵聽器方法的 DropTargetDragEvent 實例上的 getTransferable()。

注意，應該只在各自偵聽器方法內調用 DropTargetDragEvent 實例上的 getTransferable()，並且應該在該方法返回前從返回的 Transferable 檢索所有所需的資料。

從以下版本開始：

1.4

另請參見：

DropTargetEvent, DropTargetListener

建構子摘要

DropTargetAdapter()

方法摘要

void	dragEnter(DropTargetDragEvent dtde) 當鼠標指針進入向此偵聽器註冊的 DropTarget 放置點可操作部分時，則在拖動操作正在進行的同時調用該方法。
void	dragExit(DropTargetEvent dte) 當鼠標指針已經離開向此偵聽器註冊的 DropTarget 放置點可操作部分時，則在拖動操作正在進行時調用該方法。
void	dragOver(DropTargetDragEvent dtde) 當鼠標指針仍舊處於向此偵聽器註冊的 DropTarget 放置點可操作部分上時，則在拖動操作正在進行時調用該方法。
void	dropActionChanged(DropTargetDragEvent dtde) 如果使用者已經修改了當前的放置操作，則調用該方法。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

從介面 java.awt.dnd.DropTargetListener 繼承的方法

drop

建構子詳細資訊

DropTargetAdapter

public DropTargetAdapter()

方法詳細資訊

dragEnter

public void dragEnter(DropTargetDragEvent dtde)

當鼠標指針進入向此偵聽器註冊的 DropTarget 放置點可操作部分時，則在拖動操作正在進行的同時調用該方法。

指定者：

介面 DropTargetListener 中的 dragEnter

參數：

dtde - DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent dtde)

當鼠標指針仍舊處於向此偵聽器註冊的 DropTarget 放置點可操作部分上時，則在拖動操作正在進行時調用該方法。

指定者：

介面 DropTargetListener 中的 dragOver

參數：

dtde - DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

如果使用者已經修改了當前的放置操作，則調用該方法。

指定者：

介面 DropTargetListener 中的 dropActionChanged

參數：

dtde - DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent dte)

當鼠標指針已經離開向此偵聽器註冊的 DropTarget 放置點可操作部分時，則在拖動操作正在進行時調用該方法。

指定者：

介面 DropTargetListener 中的 dragExit

參數：

dte - DropTargetEvent