java.awt.dnd

Class DragSourceContext

Implemented Interfaces:
DragSourceListener, DragSourceMotionListener, EventListener, Serializable

public class DragSourceContext
extends Object
implements DragSourceListener, DragSourceMotionListener, Serializable

Since:
1.2
See Also:
Serialized Form

Field Summary

protected static int
CHANGED
protected static int
DEFAULT
protected static int
ENTER
protected static int
OVER

Constructor Summary

DragSourceContext(DragSourceContextPeer peer, DragGestureEvent trigger, Cursor cursor, Image image, Point offset, Transferable trans, DragSourceListener dsl)
Initializes a drag source context.

Method Summary

void
addDragSourceListener(DragSourceListener dsl)
Adds a DragSourceListener.
void
dragDropEnd(DragSourceDropEvent e)
Called when the drag and drop operation is complete.
void
dragEnter(DragSourceDragEvent e)
Called when the cursor hotspot enters a drop site which will accept the drag.
void
dragExit(DragSourceEvent e)
Called when the cursor hotspot moves outside of a drop site which will accept the drag.
void
dragMouseMoved(DragSourceDragEvent e)
Called whenever the mouse is moved during a drag-and-drop operation.
void
dragOver(DragSourceDragEvent e)
Called when the cursor hotspot moves inside of a drop site which will accept the drag.
void
dropActionChanged(DragSourceDragEvent e)
Called when the user modifies the drop gesture.
Component
getComponent()
Cursor
getCursor()
DragSource
getDragSource()
int
getSourceActions()
Transferable
getTransferable()
DragGestureEvent
getTrigger()
void
removeDragSourceListener(DragSourceListener dsl)
void
setCursor(Cursor cursor)
void
transferablesFlavorsChanged()
protected void
updateCurrentCursor(int dropOp, int targetAct, int status)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

CHANGED

protected static final int CHANGED
Field Value:
3

DEFAULT

protected static final int DEFAULT
Field Value:
0

ENTER

protected static final int ENTER
Field Value:
1

OVER

protected static final int OVER
Field Value:
2

Constructor Details

DragSourceContext

public DragSourceContext(DragSourceContextPeer peer,
                         DragGestureEvent trigger,
                         Cursor cursor,
                         Image image,
                         Point offset,
                         Transferable trans,
                         DragSourceListener dsl)
Initializes a drag source context.
Throws:
IllegalArgumentException - If Component or DragSource of trigger are null, the drag action for the trigger event is DnDConstants.ACTION_NONE or if the source actions for the DragGestureRecognizer associated with the trigger event are equal to DnDConstants.ACTION_NONE.
NullPointerException - If peer or trigger is null.

Method Details

addDragSourceListener

public void addDragSourceListener(DragSourceListener dsl)
            throws TooManyListenersException
Adds a DragSourceListener.
Throws:
TooManyListenersException - If a DragSourceListener has already been added.

dragDropEnd

public void dragDropEnd(DragSourceDropEvent e)
Called when the drag and drop operation is complete. After this event, getDropSuccess of the event is valid, and getDropAction holds the action requested by the drop site. Furthermore, the DragSourceContext is invalidated.
Specified by:
dragDropEnd in interface DragSourceListener
Parameters:
e - the drag source drag event

dragEnter

public void dragEnter(DragSourceDragEvent e)
Called when the cursor hotspot enters a drop site which will accept the drag.
Specified by:
dragEnter in interface DragSourceListener
Parameters:
e - the drag source drag event

dragExit

public void dragExit(DragSourceEvent e)
Called when the cursor hotspot moves outside of a drop site which will accept the drag. This could also happen if the drop site is no longer active, or no longer accepts the drag.
Specified by:
dragExit in interface DragSourceListener
Parameters:
e - the drag source drag event

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent e)
Called whenever the mouse is moved during a drag-and-drop operation.
Specified by:
dragMouseMoved in interface DragSourceMotionListener
Parameters:
e - the event

dragOver

public void dragOver(DragSourceDragEvent e)
Called when the cursor hotspot moves inside of a drop site which will accept the drag.
Specified by:
dragOver in interface DragSourceListener
Parameters:
e - the drag source drag event

dropActionChanged

public void dropActionChanged(DragSourceDragEvent e)
Called when the user modifies the drop gesture. This is often the case when additional mouse or key events are received during the drag.
Specified by:
dropActionChanged in interface DragSourceListener
Parameters:
e - the drag source drag event

getComponent

public Component getComponent()

getCursor

public Cursor getCursor()

getDragSource

public DragSource getDragSource()

getSourceActions

public int getSourceActions()

getTransferable

public Transferable getTransferable()

getTrigger

public DragGestureEvent getTrigger()

removeDragSourceListener

public void removeDragSourceListener(DragSourceListener dsl)

setCursor

public void setCursor(Cursor cursor)

transferablesFlavorsChanged

public void transferablesFlavorsChanged()

updateCurrentCursor

protected void updateCurrentCursor(int dropOp,
                                   int targetAct,
                                   int status)

DragSourceContext.java -- Copyright (C) 2002 Free Software Foundation This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.