- java.lang.Object
-
- java.util.EventObject
-
- java.awt.dnd.DropTargetEvent
-
- java.awt.dnd.DropTargetDragEvent
-
- All Implemented Interfaces:
-
Serializable
public class DropTargetDragEvent extends DropTargetEvent
所述DropTargetDragEvent
被输送到DropTargetListener
经由其dragEnter事件()和的dragover()方法。DropTargetDragEvent
报告源放置操作和反映拖动操作的当前状态的用户放置操作。源放置操作是
DnDConstants
的按位掩码,表示拖动操作支持的拖放操作的集合。用户放置操作取决于拖动源支持的放置操作和用户选择的放置操作。 用户可以在拖动操作期间按修改键来选择放置操作:
Ctrl + Shift -> ACTION_LINK Ctrl -> ACTION_COPY Shift -> ACTION_MOVE
如果用户选择放置操作,则用户放置操作是DnDConstants
中的一个,表示当拖放源支持该放置操作时所选择的放置操作,如果拖放源不支持此拖动操作,则表示DnDConstants.ACTION_NONE
。如果用户没有选drop操作,一组
DnDConstants
表示设置拖动源支持的放置动作中搜索DnDConstants.ACTION_MOVE
,然后DnDConstants.ACTION_COPY
,然后为DnDConstants.ACTION_LINK
和用户drop操作是找到的第一个常量。 如果没有找到常量,则用户删除操作是DnDConstants.ACTION_NONE
。- 从以下版本开始:
- 1.2
- 另请参见:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class java.awt.dnd.DropTargetEvent
context
-
Fields inherited from class java.util.EventObject
source
-
-
构造方法摘要
构造方法 Constructor 描述 DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
构造一个DropTargetDragEvent
给出的DropTargetContext
此操作中,“拖”的位置Cursor
“在S热点Component
坐标”,用户放置动作,和源drop操作。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 void
acceptDrag(int dragOperation)
接受拖动DataFlavor[]
getCurrentDataFlavors()
该方法返回当前DataFlavor
从SDropTargetContext
。List<DataFlavor>
getCurrentDataFlavorsAsList()
此方法返回当前的DataFlavor
s作为java.util.List
int
getDropAction()
此方法返回用户放置操作。Point
getLocation()
该方法返回一个Point
表示Cursor
的当前位置在Component'
的坐标内。int
getSourceActions()
此方法返回源放置操作。Transferable
getTransferable()
此方法返回表示与当前拖动操作相关联的数据的Transferable对象。boolean
isDataFlavorSupported(DataFlavor df)
此方法返回一个boolean
指示是否支持指定的DataFlavor
。void
rejectDrag()
由于检查了dropAction
或可用的DataFlavor
类型,因此拒绝拖动。-
Methods inherited from class java.awt.dnd.DropTargetEvent
getDropTargetContext
-
Methods inherited from class java.util.EventObject
getSource, toString
-
-
-
-
构造方法详细信息
-
DropTargetDragEvent
public DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
构造一个DropTargetDragEvent
给出的DropTargetContext
此操作中,“拖”的位置Cursor
“在S热点Component
坐标”,用户放置动作,和源drop操作。- 参数
-
dtc
- 此操作的DropTargetContext -
cursorLocn
- 组件坐标中“拖动”光标的热点的位置 -
dropAction
- 用户放弃操作 -
srcActions
- 源丢弃操作 - 异常
-
NullPointerException
- 如果cursorLocn为空 -
IllegalArgumentException
- 如果dropAction不是DnDConstants
。 -
IllegalArgumentException
-如果srcActions不是位掩码DnDConstants
。 -
IllegalArgumentException
- 如果dtc是null
。
-
-
方法详细信息
-
getLocation
public Point getLocation()
此方法返回一个Point
指示Component'
的坐标中的Cursor
的当前位置。- 结果
-
当前光标位置在
Component
。
-
getCurrentDataFlavors
public DataFlavor[] getCurrentDataFlavors()
此方法从DropTargetContext
返回当前的DataFlavor
s。- 结果
- 来自DropTargetContext的当前DataFlavors
-
getCurrentDataFlavorsAsList
public List<DataFlavor> getCurrentDataFlavorsAsList()
此方法返回当前的DataFlavor
作为java.util.List
- 结果
-
一个
java.util.List
的当前DataFlavor
s
-
isDataFlavorSupported
public boolean isDataFlavorSupported(DataFlavor df)
此方法返回一个boolean
指示是否支持指定的DataFlavor
。- 参数
-
df
-DataFlavor
要测试 - 结果
- 如果支持特定的DataFlavor
-
getSourceActions
public int getSourceActions()
此方法返回源放置操作。- 结果
- 源放弃操作
-
getDropAction
public int getDropAction()
此方法返回用户放置操作。- 结果
- 用户放下动作
-
getTransferable
public Transferable getTransferable()
此方法返回表示与当前拖动操作相关联的数据的Transferable对象。- 结果
- 与拖动操作相关联的Transferable
- 异常
-
InvalidDnDOperationException
- 如果与拖动操作相关联的数据不可用 - 从以下版本开始:
- 1.5
-
acceptDrag
public void acceptDrag(int dragOperation)
接受拖动 此方法应来自被称为DropTargetListeners dragEnter
,dragOver
和dropActionChanged
方法如果实现希望接受从比由用户选择如由表示的一个其它srcActions操作dropAction
。- 参数
-
dragOperation
- 目标接受的操作
-
rejectDrag
public void rejectDrag()
Rejects the drag as a result of examining either thedropAction
or the availableDataFlavor
types.
-
-