java.awt.dnd
類別 DropTargetContext

java.lang.Object
  java.awt.dnd.DropTargetContext

所有已實作的介面：

Serializable

public class DropTargetContext
extends Object
implements Serializable

每當與 Drag 和 Drop 操作相關的邏輯鼠標和與 DropTarget 相關的 Component 的可見幾何結構重合時，就創建一個 DropTargetContext。DropTargetContext 為放置操作的潛在接收者提供一種機制，該機制既為終端使用者提供適當的拖動反饋，也影響適當的後續資料傳輸。

從以下版本開始：

1.2

另請參見：

序列化表格

巢狀類別摘要

protected class

DropTargetContext.TransferableProxy TransferableProxy 是一個說明器內部類別，它實作 Transferable 介面，並用作另一個表示特定 drag-n-drop（拖放）操作資料轉換的 Transferable 物件的代理。

方法摘要

protected void	acceptDrag(int dragOperation) 接受該 Drag。
protected void	acceptDrop(int dropOperation) 調用以指示放置操作是可接受的（使用指定的操作）。
void	addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp) 與 DropTargetContextPeer 關聯時調用。
protected Transferable	createTransferableProxy(Transferable t, boolean local) 創建一個代理指定 Transferable 的 TransferableProxy。
void	dropComplete(boolean success) 此方法指示放置操作完成以及成功與否。
Component	getComponent() 此方法返回與此 DropTargetContext 相關的 Component。
protected DataFlavor[]	getCurrentDataFlavors() 獲取此操作的 Transferable 操作數的可用 DataFlavor。
protected List<DataFlavor>	getCurrentDataFlavorsAsList() 此方法返回 Transferable 操作數當前可用的 DataFlavor，作為一個 java.util.List。
DropTarget	getDropTarget() 此方法返回與此 DropTargetContext 相關的 DropTarget。
protected int	getTargetActions() 此方法返回一個 int，表示此 DropTarget 將接受的當前操作。
protected Transferable	getTransferable() 獲取此操作的 Transferable（代理）操作數
protected boolean	isDataFlavorSupported(DataFlavor df) 此方法返回一個 boolean 值，指示給定的 DataFlavor 是否受此 DropTargetContext 支持。
protected void	rejectDrag() 拒絕該 Drag。
protected void	rejectDrop() 調用以指示放置操作是不可接受的。
void	removeNotify() 取消與 DropTargetContextPeer 的關聯時調用。
protected void	setTargetActions(int actions) 此方法設置此 DropTarget 可接受的當前操作。

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

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

方法詳細資訊

getDropTarget

public DropTarget getDropTarget()

此方法返回與此 DropTargetContext 相關的 DropTarget。

返回：

與此 DropTargetContext 相關的 DropTarget

getComponent

public Component getComponent()

此方法返回與此 DropTargetContext 相關的 Component。

返回：

與此 Context 相關的 Component

addNotify

public void addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)

與 DropTargetContextPeer 關聯時調用。

參數：

dtcp - DropTargetContextPeer

removeNotify

public void removeNotify()

取消與 DropTargetContextPeer 的關聯時調用。

setTargetActions

protected void setTargetActions(int actions)

此方法設置此 DropTarget 可接受的當前操作。

參數：

actions - 一個 int，表示受支持的操作

getTargetActions

protected int getTargetActions()

此方法返回一個 int，表示此 DropTarget 將接受的當前操作。

返回：

此 DropTarget 可接受的當前操作

dropComplete

public void dropComplete(boolean success)
                  throws InvalidDnDOperationException

此方法指示放置操作完成以及成功與否。

參數：

success - 如果成功，則為 true；否則為 false

拋出：

InvalidDnDOperationException - 如果放置操作未完成/成功

acceptDrag

protected void acceptDrag(int dragOperation)

接受該 Drag。

參數：

dragOperation - 受支持的操作

rejectDrag

protected void rejectDrag()

拒絕該 Drag。

acceptDrop

protected void acceptDrop(int dropOperation)

調用以指示放置操作是可接受的（使用指定的操作）。在 DropTargetListener.drop 方法調用期間必須被調用。

參數：

dropOperation - 受支持的操作

rejectDrop

protected void rejectDrop()

調用以指示放置操作是不可接受的。在 DropTargetListener.drop 方法調用期間必須被調用。

getCurrentDataFlavors

protected DataFlavor[] getCurrentDataFlavors()

獲取此操作的 Transferable 操作數的可用 DataFlavor。

返回：

一個 DataFlavor[]，它包含受支持的 Transferable 操作數的 DataFlavor。

getCurrentDataFlavorsAsList

protected List<DataFlavor> getCurrentDataFlavorsAsList()

此方法返回 Transferable 操作數當前可用的 DataFlavor，作為一個 java.util.List。

返回：

當前可用的 DataFlavor，作為一個 java.util.List

isDataFlavorSupported

protected boolean isDataFlavorSupported(DataFlavor df)

此方法返回一個 boolean 值，指示給定的 DataFlavor 是否受此 DropTargetContext 支持。

參數：

df - DataFlavor

返回：

指定的 DataFlavor 是否受支持

getTransferable

protected Transferable getTransferable()
                                throws InvalidDnDOperationException

獲取此操作的 Transferable（代理）操作數

返回：

Transferable

拋出：

InvalidDnDOperationException - 如果放置操作未完成/成功

createTransferableProxy

protected Transferable createTransferableProxy(Transferable t,
                                               boolean local)

創建一個代理指定 Transferable 的 TransferableProxy。

參數：

t - 要被代理的 Transferable

local - 如果 t 表示本地 drag-n-drop 操作的結果，則為 true。

返回：

新的 TransferableProxy 實例。