ilog.views.sdm.util

Class IlvSDMDropTarget

java.lang.Object

ilog.views.sdm.util.IlvSDMDropTarget

All Implemented Interfaces:

IlvSDMConstants, DropTargetListener, Serializable, EventListener

public class IlvSDMDropTarget
extends Object
implements IlvSDMConstants, DropTargetListener, Serializable

The class IlvSDMDropTarget handles the "drop" part of drag-and-drop interactions between SDM engines. To enable drag-and-drop between two SDM engines, create an IlvSDMDragSource associated with one engine and an IlvSDMDropTarget associated with the other engine.

Since:

JViews 4.0

See Also:

Serialized Form

Field Summary

Fields inherited from interface ilog.views.sdm.util.IlvSDMConstants

ANCHOR_TAG

Constructor Summary

Constructors

Constructor and Description
IlvSDMDropTarget(IlvSDMEngine engine, IlvManagerView view) Creates a new drop target associated with the specified engine and the specified view.

Method Summary

Modifier and Type	Method and Description
void	dragEnter(DropTargetDragEvent e) Implementation of DropTargetListener.
void	dragExit(DropTargetEvent e) Implementation of DropTargetListener.
void	dragOver(DropTargetDragEvent e) Implementation of DropTargetListener.
void	drop(DropTargetDropEvent e) Implementation of DropTargetListener.
void	dropActionChanged(DropTargetDragEvent e) Implementation of DropTargetListener.
IlvSDMEngine	getEngine() Returns the SDM engine with which this drag source is associated.
IlvManagerView	getView() Returns the manager view with which this drag source is associated.
boolean	isEnabled() Returns the flag indicating whether the drag source is enabled.
protected void	objectDropped(Object parent, Object obj, DropTargetDropEvent e) This method is called during a drop, for each object that was dropped, after the object was inserted in the model and its graphic representation was moved to the drop location.
void	setEnabled(boolean enabled) Enables or disables the drag source.

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvSDMDropTarget

public IlvSDMDropTarget(IlvSDMEngine engine,
                        IlvManagerView view)

Creates a new drop target associated with the specified engine and the specified view.

Parameters:

engine - The SDM engine.

view - The manager view to which objects will be dropped.

Method Detail

getEngine

public IlvSDMEngine getEngine()

Returns the SDM engine with which this drag source is associated.

getView

public IlvManagerView getView()

Returns the manager view with which this drag source is associated.

setEnabled

public void setEnabled(boolean enabled)

Enables or disables the drag source.

Parameters:

enabled - If true, the drag source is enabled. Otherwise, no drag can be initiated.

isEnabled

public boolean isEnabled()

Returns the flag indicating whether the drag source is enabled.

dragEnter

public void dragEnter(DropTargetDragEvent e)

Implementation of DropTargetListener.

Specified by:

dragEnter in interface DropTargetListener

Parameters:

e - The event.

dragExit

public void dragExit(DropTargetEvent e)

Implementation of DropTargetListener. This method does nothing.

Specified by:

dragExit in interface DropTargetListener

Parameters:

e - The event.

dragOver

public void dragOver(DropTargetDragEvent e)

Implementation of DropTargetListener. This method does nothing.

Specified by:

dragOver in interface DropTargetListener

Parameters:

e - The event.

drop

public void drop(DropTargetDropEvent e)

Implementation of DropTargetListener. This method adds a copy of the dragged object to the data model of this view.

If IlvSDMEngine.isDropToGroupEnabled() returns true, the new object is created as a child of the parent object located at the specified coordinates. If IlvSDMEngine.isDropToGroupEnabled() returns false, or if no parent is at the specified location, the new object is created at the top level of the model.

Specified by:

drop in interface DropTargetListener

Parameters:

e - The event.

objectDropped

protected void objectDropped(Object parent,
                             Object obj,
                             DropTargetDropEvent e)

This method is called during a drop, for each object that was dropped, after the object was inserted in the model and its graphic representation was moved to the drop location.

This method can be overridden to modify the properties of the dropped object depending on the location where it was dropped.

The default implementation of this method does nothing, so you do not need to call the superclass when you override it.

Parameters:

parent - The parent in which the object was dropped, or null if the object was dropped at the top level.

obj - The dropped object.

e - The drop event.

Since:

JViews 6.0

dropActionChanged

public void dropActionChanged(DropTargetDragEvent e)

Implementation of DropTargetListener. This method does nothing.

Specified by:

dropActionChanged in interface DropTargetListener

Parameters:

e - The event.