/*
* Copyright (c) 1998, 2006, Oracle and/or its affiliates. All rights reserved.
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*/
package java.awt.dnd;
import java.util.EventListener;
/**
* The listener interface for receiving drag gesture events.
* This interface is intended for a drag gesture recognition
* implementation. See a specification for {@code DragGestureRecognizer}
* for details on how to register the listener interface.
* Upon recognition of a drag gesture the {@code
* DragGestureRecognizer} calls this interface's
* {@link #dragGestureRecognized dragGestureRecognized()}
* method and passes a {@code DragGestureEvent}.
*
* @see java.awt.dnd.DragGestureRecognizer
* @see java.awt.dnd.DragGestureEvent
* @see java.awt.dnd.DragSource
*/
public interface DragGestureListener extends EventListener {
/**
* This method is invoked by the {@code DragGestureRecognizer}
* when the {@code DragGestureRecognizer} detects a platform-dependent
* drag initiating gesture. To intiate the drag and drop operation,
* if approtiate, {@link DragGestureEvent#startDrag startDrag()} method on
* the {@code DragGestureEvent} has to be invoked.
* <P>
* @see java.awt.dnd.DragGestureRecognizer
* @see java.awt.dnd.DragGestureEvent
* @param dge the <code>DragGestureEvent</code> describing
* the gesture that has just occurred
*/
void dragGestureRecognized(DragGestureEvent dge);
}