< prev index next >
src/java.desktop/share/classes/java/awt/dnd/DragSourceListener.java
Print this page
*** 26,48 ****
package java.awt.dnd;
import java.util.EventListener;
/**
! * The <code>DragSourceListener</code> defines the
* event interface for originators of
* Drag and Drop operations to track the state of the user's gesture, and to
* provide appropriate "drag over"
* feedback to the user throughout the
* Drag and Drop operation.
* <p>
! * The drop site is <i>associated with the previous <code>dragEnter()</code>
! * invocation</i> if the latest invocation of <code>dragEnter()</code> on this
* listener:
* <ul>
* <li>corresponds to that drop site and
! * <li> is not followed by a <code>dragExit()</code> invocation on this listener.
* </ul>
*
* @since 1.2
*/
--- 26,48 ----
package java.awt.dnd;
import java.util.EventListener;
/**
! * The {@code DragSourceListener} defines the
* event interface for originators of
* Drag and Drop operations to track the state of the user's gesture, and to
* provide appropriate "drag over"
* feedback to the user throughout the
* Drag and Drop operation.
* <p>
! * The drop site is <i>associated with the previous {@code dragEnter()}
! * invocation</i> if the latest invocation of {@code dragEnter()} on this
* listener:
* <ul>
* <li>corresponds to that drop site and
! * <li> is not followed by a {@code dragExit()} invocation on this listener.
* </ul>
*
* @since 1.2
*/
*** 56,66 ****
* dependent drop site.
* <LI>The drop site is active.
* <LI>The drop site accepts the drag.
* </UL>
*
! * @param dsde the <code>DragSourceDragEvent</code>
*/
void dragEnter(DragSourceDragEvent dsde);
/**
* Called as the cursor's hotspot moves over a platform-dependent drop site.
--- 56,66 ----
* dependent drop site.
* <LI>The drop site is active.
* <LI>The drop site accepts the drag.
* </UL>
*
! * @param dsde the {@code DragSourceDragEvent}
*/
void dragEnter(DragSourceDragEvent dsde);
/**
* Called as the cursor's hotspot moves over a platform-dependent drop site.
*** 71,92 ****
* dragEnter() invocation.
* <LI>The drop site is still active.
* <LI>The drop site accepts the drag.
* </UL>
*
! * @param dsde the <code>DragSourceDragEvent</code>
*/
void dragOver(DragSourceDragEvent dsde);
/**
* Called when the user has modified the drop gesture.
* This method is invoked when the state of the input
* device(s) that the user is interacting with changes.
* Such devices are typically the mouse buttons or keyboard
* modifiers that the user is interacting with.
*
! * @param dsde the <code>DragSourceDragEvent</code>
*/
void dropActionChanged(DragSourceDragEvent dsde);
/**
* Called as the cursor's hotspot exits a platform-dependent drop site.
--- 71,92 ----
* dragEnter() invocation.
* <LI>The drop site is still active.
* <LI>The drop site accepts the drag.
* </UL>
*
! * @param dsde the {@code DragSourceDragEvent}
*/
void dragOver(DragSourceDragEvent dsde);
/**
* Called when the user has modified the drop gesture.
* This method is invoked when the state of the input
* device(s) that the user is interacting with changes.
* Such devices are typically the mouse buttons or keyboard
* modifiers that the user is interacting with.
*
! * @param dsde the {@code DragSourceDragEvent}
*/
void dropActionChanged(DragSourceDragEvent dsde);
/**
* Called as the cursor's hotspot exits a platform-dependent drop site.
*** 104,126 ****
* <UL>
* <LI> The drop site associated with the previous dragEnter() invocation
* has rejected the drag.
* </UL>
*
! * @param dse the <code>DragSourceEvent</code>
*/
void dragExit(DragSourceEvent dse);
/**
* This method is invoked to signify that the Drag and Drop
* operation is complete. The getDropSuccess() method of
! * the <code>DragSourceDropEvent</code> can be used to
* determine the termination state. The getDropAction() method
* returns the operation that the drop site selected
* to apply to the Drop operation. Once this method is complete, the
! * current <code>DragSourceContext</code> and
* associated resources become invalid.
*
! * @param dsde the <code>DragSourceDropEvent</code>
*/
void dragDropEnd(DragSourceDropEvent dsde);
}
--- 104,126 ----
* <UL>
* <LI> The drop site associated with the previous dragEnter() invocation
* has rejected the drag.
* </UL>
*
! * @param dse the {@code DragSourceEvent}
*/
void dragExit(DragSourceEvent dse);
/**
* This method is invoked to signify that the Drag and Drop
* operation is complete. The getDropSuccess() method of
! * the {@code DragSourceDropEvent} can be used to
* determine the termination state. The getDropAction() method
* returns the operation that the drop site selected
* to apply to the Drop operation. Once this method is complete, the
! * current {@code DragSourceContext} and
* associated resources become invalid.
*
! * @param dsde the {@code DragSourceDropEvent}
*/
void dragDropEnd(DragSourceDropEvent dsde);
}
< prev index next >