- All Implemented Interfaces:
- Serializable
DropTargetDragEvent is delivered to a
 DropTargetListener via its
 dragEnter() and dragOver() methods.
 
 The DropTargetDragEvent reports the source drop actions
 and the user drop action that reflect the current state of
 the drag operation.
 
 Source drop actions is a bitwise mask of DnDConstants
 that represents the set of drop actions supported by the drag source for
 this drag operation.
 
User drop action depends on the drop actions supported by the drag source and the drop action selected by the user. The user can select a drop action by pressing modifier keys during the drag operation:
Ctrl + Shift -> ACTION_LINK Ctrl -> ACTION_COPY Shift -> ACTION_MOVEIf the user selects a drop action, the user drop action is one of
DnDConstants that represents the selected drop action if this
 drop action is supported by the drag source or
 DnDConstants.ACTION_NONE if this drop action is not supported
 by the drag source.
 
 If the user doesn't select a drop action, the set of
 DnDConstants that represents the set of drop actions supported
 by the drag source is searched for DnDConstants.ACTION_MOVE,
 then for DnDConstants.ACTION_COPY, then for
 DnDConstants.ACTION_LINK and the user drop action is the
 first constant found. If no constant is found the user drop action
 is DnDConstants.ACTION_NONE.
- Since:
- 1.2
- See Also:
- 
Field SummaryFields declared in class java.awt.dnd.DropTargetEventcontextFields declared in class java.util.EventObjectsource
- 
Constructor SummaryConstructorsConstructorDescriptionDropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions) Construct aDropTargetDragEventgiven theDropTargetContextfor this operation, the location of the "Drag"Cursor's hotspot in theComponent's coordinates, the user drop action, and the source drop actions.
- 
Method SummaryModifier and TypeMethodDescriptionvoidacceptDrag(int dragOperation) Accepts the drag.This method returns the currentDataFlavors from theDropTargetContext.This method returns the currentDataFlavors as ajava.util.ListintThis method returns the user drop action.This method returns aPointindicating theCursor's current location within theComponent's coordinates.intThis method returns the source drop actions.This method returns the Transferable object that represents the data associated with the current drag operation.booleanThis method returns abooleanindicating if the specifiedDataFlavoris supported.voidRejects the drag as a result of examining either thedropActionor the availableDataFlavortypes.Methods declared in class java.awt.dnd.DropTargetEventgetDropTargetContextMethods declared in class java.util.EventObjectgetSource, toString
- 
Constructor Details- 
DropTargetDragEventConstruct aDropTargetDragEventgiven theDropTargetContextfor this operation, the location of the "Drag"Cursor's hotspot in theComponent's coordinates, the user drop action, and the source drop actions.- Parameters:
- dtc- The DropTargetContext for this operation
- cursorLocn- The location of the "Drag" Cursor's hotspot in Component coordinates
- dropAction- The user drop action
- srcActions- The source drop actions
- Throws:
- NullPointerException- if cursorLocn is null
- IllegalArgumentException- if dropAction is not one of- DnDConstants.
- IllegalArgumentException- if srcActions is not a bitwise mask of- DnDConstants.
- IllegalArgumentException- if dtc is- null.
 
 
- 
- 
Method Details- 
getLocationThis method returns aPointindicating theCursor's current location within theComponent's coordinates.- Returns:
- the current cursor location in
 Component's coords.
 
- 
getCurrentDataFlavorsThis method returns the currentDataFlavors from theDropTargetContext.- Returns:
- current DataFlavors from the DropTargetContext
 
- 
getCurrentDataFlavorsAsListThis method returns the currentDataFlavors as ajava.util.List- Returns:
- a java.util.Listof the CurrentDataFlavors
 
- 
isDataFlavorSupportedThis method returns abooleanindicating if the specifiedDataFlavoris supported.- Parameters:
- df- the- DataFlavorto test
- Returns:
- if a particular DataFlavor is supported
 
- 
getSourceActionspublic int getSourceActions()This method returns the source drop actions.- Returns:
- the source drop actions
 
- 
getDropActionpublic int getDropAction()This method returns the user drop action.- Returns:
- the user drop action
 
- 
getTransferableThis method returns the Transferable object that represents the data associated with the current drag operation.- Returns:
- the Transferable associated with the drag operation
- Throws:
- InvalidDnDOperationException- if the data associated with the drag operation is not available
- Since:
- 1.5
 
- 
acceptDragpublic void acceptDrag(int dragOperation) Accepts the drag. This method should be called from aDropTargetListeners dragEnter,dragOver, anddropActionChangedmethods if the implementation wishes to accept an operation from the srcActions other than the one selected by the user as represented by thedropAction.- Parameters:
- dragOperation- the operation accepted by the target
 
- 
rejectDragpublic void rejectDrag()Rejects the drag as a result of examining either thedropActionor the availableDataFlavortypes.
 
-