- java.lang.Object
-
- java.util.EventObject
-
- java.awt.dnd.DropTargetEvent
-
- java.awt.dnd.DropTargetDragEvent
-
- 实现的所有接口
-
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
如果这个放置动作不被拖动源所支持。如果用户没有选择降动作,一套
DnDConstants
表示设置拖动源支持的放置动作中搜索DnDConstants.ACTION_MOVE
,然后DnDConstants.ACTION_COPY
,然后DnDConstants.ACTION_LINK
和用户drop操作是找到的第一个常量。 如果未找到常量,则用户删除操作为DnDConstants.ACTION_NONE
。- 从以下版本开始:
- 1.2
- 另请参见:
- Serialized Form
-
-
字段汇总
-
声明的属性在类 java.awt.dnd.DropTargetEvent
context
-
声明的属性在类 java.util.EventObject
source
-
-
构造方法摘要
构造方法 构造器 描述 DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
构造一个DropTargetDragEvent
给定DropTargetContext
进行此操作,“拖动”Cursor
的热点位于Component
的坐标,用户放置操作和源放置操作的位置。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 void
acceptDrag(int dragOperation)
接受阻力。DataFlavor[]
getCurrentDataFlavors()
该方法返回当前DataFlavor
从SDropTargetContext
。List<DataFlavor>
getCurrentDataFlavorsAsList()
此方法将当前DataFlavor
s作为java.util.List
int
getDropAction()
此方法返回用户放置操作。Point
getLocation()
此方法返回Point
指示Cursor
在Component'
s坐标内的当前位置。int
getSourceActions()
此方法返回源放置操作。Transferable
getTransferable()
此方法返回Transferable对象,该对象表示与当前拖动操作关联的数据。boolean
isDataFlavorSupported(DataFlavor df)
此方法返回boolean
指示是否支持指定的DataFlavor
。void
rejectDrag()
检查dropAction
或可用的DataFlavor
类型时,拒绝拖动。-
声明方法的类 java.awt.dnd.DropTargetEvent
getDropTargetContext
-
声明方法的类 java.util.EventObject
getSource, toString
-
-
-
-
构造方法详细信息
-
DropTargetDragEvent
public DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
构造一个DropTargetDragEvent
给定DropTargetContext
用于此操作,Component
的坐标中的“拖动”Cursor
的热点位置,用户放置操作和源放置操作。- 参数
-
dtc
- 此操作的DropTargetContext -
cursorLocn
- “组件”坐标中“拖动”光标的热点的位置 -
dropAction
- 用户放弃操作 -
srcActions
- 源丢弃操作 - 异常
-
NullPointerException
- 如果cursorLocn为null -
IllegalArgumentException
- 如果dropAction不是DnDConstants
。 -
IllegalArgumentException
-如果srcActions不是位掩码DnDConstants
。 -
IllegalArgumentException
- 如果dtc是null
。
-
-
方法详细信息
-
getLocation
public Point getLocation()
此方法返回Point
指示Cursor
在Component'
坐标系内的当前位置。- 结果
-
当前光标位置在
Component
的坐标上。
-
getCurrentDataFlavors
public DataFlavor[] getCurrentDataFlavors()
该方法返回当前DataFlavor
从SDropTargetContext
。- 结果
- DropTargetContext中的当前DataFlavor
-
getCurrentDataFlavorsAsList
public List<DataFlavor> getCurrentDataFlavorsAsList()
此方法将当前DataFlavor
s作为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)
接受阻力。 如果实现希望接受来自srcActions的操作而不是用户选择的操作(如dropAction
所表示),dragOver
从DropTargetListeners dragEnter
和dropActionChanged
方法调用此方法。- 参数
-
dragOperation
- 目标接受的操作
-
rejectDrag
public void rejectDrag()
Rejects the drag as a result of examining either thedropAction
or the availableDataFlavor
types.
-
-