org.eclipse.swt.dnd.DropTargetAdapter Maven / Gradle / Ivy

/*******************************************************************************
 * Copyright (c) 2000, 2016 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.swt.dnd;


/**
 * This adapter class provides default implementations for the
 * methods described by the DropTargetListener interface.
 * 
 * Classes that wish to deal with DropTargetEvents can
 * extend this class and override only the methods which they are
 * interested in.
 * 
 *
 *
 * Please note, there are subtle difference in DND behavior on different OS's.
 * For example during a file transfer, Windows will put out the file path
 * as soon as the drag begins, where as Linux will make it available only
 * on a drop operation. For correct crossplatform behavior, it is recommended
 * to delay OS interaction until drop has occurred or verify the correctness of
 * the operation across platforms.
 * 
 *
 *
 * @see DropTargetListener
 * @see DropTargetEvent
 * @see Sample code and further information
 * @see  Eclipse corner article on DND 
 */
public class DropTargetAdapter implements DropTargetListener {

/**
 * This implementation of dragEnter permits the default
 * operation defined in event.detailto be performed on the current data type
 * defined in event.currentDataType.
 * For additional information see DropTargetListener.dragEnter.
 *
 * @param event the information associated with the drag enter event
 */
@Override
public void dragEnter(DropTargetEvent event){}

/**
 * This implementation of dragLeave does nothing.
 * For additional information see DropTargetListener.dragOperationChanged.
 *
 * @param event the information associated with the drag leave event
 */
@Override
public void dragLeave(DropTargetEvent event){}

/**
 * This implementation of dragOperationChanged permits the default
 * operation defined in event.detailto be performed on the current data type
 * defined in event.currentDataType.
 * For additional information see DropTargetListener.dragOperationChanged.
 *
 * @param event the information associated with the drag operation changed event
 */
@Override
public void dragOperationChanged(DropTargetEvent event){}

/**
 * This implementation of dragOver permits the default
 * operation defined in event.detailto be performed on the current data type
 * defined in event.currentDataType.
 * For additional information see DropTargetListener.dragOver.
 *
 * @param event the information associated with the drag over event
 */
@Override
public void dragOver(DropTargetEvent event){}

/**
 * This implementation of drop does nothing.
 * For additional information see DropTargetListener.drop.
 *
 * @param event the information associated with the drop event
 */
@Override
public void drop(DropTargetEvent event){}

/**
 * This implementation of dropAccept permits the default
 * operation defined in event.detailto be performed on the current data type
 * defined in event.currentDataType.
 * For additional information see DropTargetListener.dropAccept.
 *
 * @param event the information associated with the drop accept event
 */
@Override
public void dropAccept(DropTargetEvent event){}

}